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Manual HP-UX Technical BASIC Reference Manual, Volume 1. 
Identification Part Number: 82860-90002 
Edition 1: October, 1984 

Update Update Number: 1 
Identification Part Number: 82860-90008 
Update Date: February 1985 

This update includes new information for volume 1 of the 
HP-UX Technical BASIC Reference Manual. Copies of pages 
2-21, 2-22, and 2-95 are enclosed with vertical lines (change 
bars) to indicate the new or changed text on each page. In 
addition, this update provides some information specific to 
Release 1.0.0 of HP-UX Technical BASIC for the Integral PC. 



Entering Data 
From the HP-IB 
Interface 



If you are using Release 1.0.0 of HP-UX Technical BASIC on 
an Integral PC equipped with Release 1.0.0 or Release 1.0.1 
of the operating system, you may experience a problem when 
ententering data from an HP-IB peripheral. You can avoid the 
problem by selecting the correct HP-IB handshake mode. 

The HP -IB controller provides two handshake modes for en- 
tering data. The default mode is intended for mass-storage 
operations, and becomes the active mode when the HP-IB in- 
terface is assigned with the fi S S I G N statement. However, if 
you use this mode when entering data from an HP -IB periph- 
eral with the E H T E R statement, you may lose the first byte of 
the incoming data. To avoid this, use the second handshake 
mode, which includes a "ready for data" hold-off. You can 
select the desired handshake mode by setting bit of HP-IB 
Status/Control Register 7. Set bit equal to "1" to select the 
"ready for data" hold-off mode. Set bit equal to "0" to return 
to the default mode. Use the STATUS statement to determine 
the current mode. For example: 



10 


ASSIGN 7 


TO 


"hpib 


20 


STATUS 7. 


7 ; 


A 


30 


DISP ,, fi=' 


i A 




40 


CONTROL 7 


, 7 


.; 1 


50 


STATUS 7. 


7 ; 


A 


60 


DISP "A=' 


.: A 




70 


ENTER 70S 




B , C 


8 


CONTROL 7 


, 7 


.: 9 


90 


STATUS 7. 


7 ; 


A 


10C 


DISP "A= 


" .: A 





Assign select code 7 to the HP-IB. 

U h e c k t h e m o d e , 

A = i nd i ca t es det au 1 1 mode . 

Change to "ready for data" hold-oft" mode 

C h e c k t h e m o d e . 

A should be = 1 

Read the data, 

C h a n g e b a c k t o d e f a u 1 1 m o d e , 

Check mode again , 

A should be = 



4 



If you do select the "ready for data" hold-off mode, be sure to 
return to the default mode after your last ENTER operation. 
Mass-storage devices on the HP-IB cannot be accessed in the 
hold-off mode. An HP-IB lock up may result. (This does not ap- 
ply to the Integral PC internal disc drive since that drive is not 
on the HP-IB.) 
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You can also avoid the loss of the first byte of data by using 
an input TRANSFER statement (FHS or INTR). In this case 
ENTER is used to input the data from an I/O buffer, rather 
than the HP-IB interface. 



Non-Controller 
Operations 



If you are using Release 1.0.0 of HP-UX Technical BASIC on 
the Integral PC, you cannot use the PASS CONTROL state- 
ment (refer to pages 2-295 and 2-296 in the HP-UX Technical 
BASIC Reference Manual, Volume 1). Also, the Integral PC is 
always the System Controller. You cannot make the Integral 
PC a non-controller device. An error will result if you attempt 
to do so. 



IJSa 



The address of the Integral PC built-in HP-IB interface is al- 
ways set to 30, and Status Register 4 always indicates this 
address. The bits of the other HP-IB status registers are con- 
sistent with the Integral PC being the Controller Active (CA) 
and System Controller (SC). 
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How to Use This 
Manual 



Introduction 



The HP-UX Technical BASIC Reference Manual is designed 
to provide reference information to experienced BASIC pro- 
grammers. The manual is divided into seven sections: 

■ The Introduction provides general information that applies 
to all BASIC keywords. The introduction also explains how 
to interpret tables and syntax diagrams in the keyword 
dictionary. 

■ The Keyword Dictionary contains an alphabetical listing 
of all the operators, functions and statements provided 
with the language. Each entry contains syntax information, 
examples, and a description of how the keyword interacts 
with other related BASIC statements. 

■ The Glossary defines many of the technical terms used re- 
peatedly in the keyword dictionary. Certain terms include a 
syntax diagram to help you understand the definition. 

■ Reference Tables contains a variety of useful tables, in- 
cluding the character set, system reset conditions, and 
various graphics conditions. 

■ The I/O Registers section contains tables of buffer and in- 
terface status and control registers. 

■ Error Messages lists all error messages and probable causes 
for the errors. 

■ The Keyword Summary groups all the BASIC keywords 
by function, allowing you to quickly locate the proper 
keyword for a particular task. 
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Using the 

Keyword 

Dictionary 



The keyword dictionary contains an alphabetical listing of all 
the HP-UX Technical BASIC keywords. Each keyword entry 
consists of a legal usage table, a definition of the keyword, a 
syntax diagram, a table of parameters, usage examples, and 
some additional descriptive information on the use of the 
keyword within programs. 



Legal Usage Table 



The Syntax 
Diagram 



The legal usage table describes in general terms the conditions 
under which the keyword can be used. 

■ If a keyword is Keyboard Executable, a properly constructed 
statement can be typed into the current alphanumeric (al- 
pha) display input line and executed by pressing ( return ) .* 
This type of immediate execution is sometimes referred to 
as execution "from the keyboard" or execution in "edit 
mode." 

■ If a keyword is Programmable, a properly constructed state- 
ment can be placed after a valid line number and stored in 
memory as part of a BASIC program. Many keywords are 
both keyboard executable and programmable. 
Nonprogrammable keywords are referred to as commands. 

■ If a keyword can be included in an IF... THEN, a statement 
containing the keyword can be placed after THEN or ELSE 
in an IF... THEN... ELSE statement. 

The syntax diagram describes pictorially how to construct a 
proper expression, statement, or command using that 
keyword. The items enclosed in ovals, circles, and rectangles 
are the various elements of the statement: 

■ The elements enclosed in ovals and circles are keywords 
and punctuation that must be typed in exactly as shown, 
except that lowercase letters can be substituted for upper- 
case letters. 



* ( RETURN") is used throughout this manual to represent the key generating a car- 
riage return character (CR), decimal value 13. 
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■ The elements enclosed in rectangles are parameters. Each 
parameter is described in the table of parameters under- 
neath the syntax diagram. In most cases, uppercase and 
lowercase letters are not interchangeable. 

The elements are connected by lines and arrows that illustrate 
how they fit together. Each line segment has only one arrow, 
meaning that the line can be followed in only one direction. 
Starting with the left side of the diagram, you can use any 
combination of elements generated by following the lines in 
the indicated direction. If an element is optional, a path exists 
around it. Many optional elements have default values listed 
in the table of parameters or description section. Whatever 
path you choose, it must terminate at the right side of the 
diagram. 

The syntax diagram does not show line numbers or line 
labels. 



Table of 
Parameters 



The Table of Parameters describes each parameter in the syn- 
tax diagram. Where proper syntax or practical semantics 
requires a parameter to evaluate within a certain range, that 
range is given. A dash (" — ") indicates no range restrictions. 
For example, in the case of numeric expressions, the param- 
eter can be any REAL number. 



Spaces The syntax diagrams do not fully describe the use of spaces. 
In general, when two elements are connected by a line and 
arrow, any number of spaces can be inserted between the ele- 
ments. In some cases, spaces are optional. For example, when 
a syntax diagram shows parameters separated by commas, 
spaces between the commas and the parameters are optional. 

When two elements are drawn adjacent to one another, there 
must be no spaces between them. 

The syntax requires spaces between BASIC keywords, variable 
names, statement labels, and numeric constants. Valid se- 
quences of letters and digits not recognized as BASIC 
keywords are interpreted as variable names. 
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Spaces are not required between keywords or variable names 
and arithmetic and relational operators. However, logical op- 
erators must be separated from keywords and variable names 
by spaces. 

Spaces should not be inserted within keywords unless explic- 
itly shown. 

Example: Examine the syntax diagram for the 
C N '.,' E R T statement: 



( CONVERT )-[—»( IN ) 



^< 



OUT 



interface 
select code 



I/O buffer 



: n — ~ — ~ . — f 



U(3 



INDEX 



To construct a valid statement, type the keyword CONVERT, 
followed by one or more spaces. Then, type the keyword I H 
or OUT, followed by one or more spaces. You must then type 
a valid interface select code (defined in the glossary) or I/O 
buffer name. The rest of the statement is optional. After leav- 
ing one or more spaces, you may type the word PAIR or 
INDE:-!, followed by a semicolon and the name of a string 
variable. 



Line Length 



The maximum number of characters that can be entered as a 
BASIC line is 160. This includes the line number, any embed- 
ded blank spaces, and a carriage return (CHR*03>) 
placed at the end of the line when it is entered into system 
memory. 
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Variables BASIC uses the following variable types: 

■ Simple numeric: 

Precisions: REAL, SHORT, or INTEGER (default = REAL) 

■ Numeric array: 

Precisions: REAL, SHORT, or INTEGER (default = REAL) 
Dimensions: one or two 

Lower bound (option base): or 1 (default =0) 
Maximum upper bound: 65,530 

■ Simple string: 

Maximum string length: 65,530 (default =18) 

■ String array: 

Maximum string length: 65,530 (default =18) 
Dimensions: one or two 

Lower bound (option base): or 1 (default =0) 
Maximum upper bound: 65,530 

String variables are differentiated from numeric variables by 
using a dollar sign ($) as the final character in all string vari- 
able names. Variable names can be up to 32 characters long. 
Any sequence of letters, numbers, and the underscore charac- 
ter can be used, except that the first character must be a letter. 
Combinations of uppercase and lowercase letters forming BA- 
SIC keywords cannot be used. 

Uppercase and lowercase letters are not interchangeable in 
variable names. 
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Line Numbers and 
Line Labels 



Every line in a program must be preceded by a unique line 
number — an integer in the range 1 through 65,535. The line 
number can be followed by an optional line label. A line label 
consists of a sequence of up to 32 letters, digits, and the un- 
derscore character; the first character must be a letter. The 
label is followed by a colon in the labeled line; the colon is 
not used when the line is referenced. 

Example: 

388 IF X<5 THEN Finished Referencing line. 



390 Finished: END 



Labeled line. 



Comments 



Multistatement 
Lines 



Comments can be added to any program line except a DRTfl 
statement. A comment is created by placing an exclamation 
point after the last character in the statement. Comments can 
also be created using the REM statement. Comments can con- 
tain any sequence and number of characters up to the 
maximum allowable line length. 

If a comment is added to a multistatement line, it must be 
placed at the end of the line. 

A multistatement line contains two or more BASIC statements 
joined by the character "@" . Multistatement lines can be exe- 
cuted both within programs and from the keyboard. The 
DATA and REM statements are not allowed in multistatement 
lines. If GOTO branching occurs in the middle of a line, the 
remaining statements on the line are not executed. 

Like single-statement lines, multistatement lines are limited to 
159 characters (plus a carriage return). 
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Hardware 
Dependencies 



Certain features of the language are dependent on how BA- 
SIC is implemented on various HP-UX systems. Factors such 
as the internal precision of numbers, the keyboard, the char- 
acter set, size of the display, availability of display windows 
and display graphics, multiuser capabilities, and ability to 
mount a removable file structure affect the use of certain 
keywords. When implementation of a keyword is machine- 
dependent, refer to documentation for your computer for 
additional information. Certain I/O statements have a sepa- 
rate description for each type interface. However, not all 
systems support every interface listed. 

Since the range of numbers varies for different devices, no 
range for numeric expressions is provided in the Keyword 
Dictionary. 



BASIC Files 



BASIC creates its own file environment within the HP-UX file 
structure. This environment includes certain file types and file 
security. BASIC-type files can be created, accessed, copied, 
and purged within BASIC. 



File Structure 



BASIC uses the HP-UX hierarchical file structure. The struc- 
ture takes the form of an upside down tree, as shown on page 
1-8. Each box is a file. To help with this discussion, file names 
are drawn inside some of the boxes. Files with shaded boxes 
are directory files containing cataloging information for the 
files branching from them. The other boxes represent non-di- 
rectory files. There are many different types of non-directory 
files, and they are utilized by the system in a number of dif- 
ferent ways. For the purpose of this discussion, however, it is 
enough to distinguish between directory and non-directory 
types. 
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System 

Root Directory 

(/) 



disci A K 

(volume label*) \j \/ 



Top- 
level 
directions 



disc2 
(volume label*) 



i — r 



File3 



Filel 



File4 



Directory2a 



~z 



T 



Directory3a 



i — i — r 



Directory3b 



File 2 




File5 



current workinj 
directory 



File6 



HI I I 



Irelative path to ThisFile 
"Directory3b/ThisFile 



labsolute path to ThisFile 
"/disc2/Directory2a/Directory3b/ThisFile" 



^Availability of volume labels is machine-dependent 



ThisFile 



The file at the apex of the structure is called the root direc- 
tory. Underneath the root directory are a variety of files, 
including the dev (device) directory and the top-level directory 
of each mounted disc. In single-user systems with removable 
file structures, the file name of the top level directory is the 
volume name of the disc. Every directory file can have under- 
neath it both directory and non-directory type files. Thus, a 
branching structure is produced. Within this structure, a path 
exists between any file and every other file in the system. 
This path is defined by a path name, which lists the route to a 
file from directory to directory. 

At any given time, the user is working in a particular direc- 
tory, called the current working directory. Files within this 
directory can be accessed by file name alone. Files outside the 
current working directory must be accessed by an HP-UX 
path name. Two types of path names exist: 

■ An absolute path name describes the path beginning at the 
root directory and moving downward to the file. 

■ The relative path name describes the path to the file begin- 
ning at the current working directory. As it winds its way 
through the file structure, a relative path can move both 
upward and downward. 

Figure 1 illustrates a current working directory (Directory2a) 
and the absolute and relative paths to the file ThisFile. The 
path names to ThisFile are: 

Absolute pathname: /disc2/Directory2a/Directory3b/ThisFile 
Relative pathname: Directory3b/ThisFile 
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Files Types 



The following file types can be created within BASIC: 
BASIC Files 







Statement 


Statement(s) 


File Type 


Contents 


Creating 


Accessing 






the File 


the File 


BASIC/PROG 


BASIC program 


STORE 


LOAD 


BASIC/SUBP 


Subprogram 


STORE 


FINDPROG, 
CALL 


BASIC/DATA 


Data 


CREATE 


ASSIGN#, 

PRINT#, 

READ# 


BASIC/GRAF 


Graphics 


GSTORE 


GLOAD 


text/data* 


ASCII data 


SAVE 


GET 


* Not a BASIC-type file. 



Certain BASIC statements and commands (e.g., GET, SAVE, 
CALL BIN) access other type files. These files must be created 
outside BASIC. Outside BASIC, all files created in BASIC are 
regarded as text files. 



File Security 



BASIC files are created with complete user read/write per- 
mission. File security is provided by the SECURE statement. 
In general, user permission status of BASIC files should not 
be changed outside of BASIC. 



The Configuration 
File 



The configuration file is an ASCII text file (created outside 
BASIC) containing a list of the compiled binary programs to 
be automatically loaded whenever BASIC is invoked. The file 
must be named ".bconfig", and must be located in the same 
directory as BASIC itself. 
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The BASIC 
Metacharacter 



The ".bconfig" file contains the file name or path name of 
each binary program to be loaded. Each file must be on a 
separate line. The file/path names are not enclosed in quotes. 

Binary programs can also be loaded individually using the 
LOflDBIN statement. 



A metacharacter sequence is used to enter non-displayable 
characters and quotation marks into quoted strings. The se- 
quence consists of the BASIC metacharacter character *~" 
(decimal code 126) followed by one through three digit char- 
acters or by a quotation mark. The metacharacter itself is 
ignored, in that it is not output by PRINT, DISP, and 
OUTPUT, it does not occupy a character position (POS), and it 
is not counted in the computation of the string length (LEH). 
However, the metacharacter is output by L I S T and P L I S T . 

When the metacharacter is followed by one, two, or three dig- 
its in the range through 255, that number is interpreted as a 
character decimal code. For example, "~7" is equivalent to 
CHR$(7), and "-2558A" is equivalent to CHR$(255)&"8A". If 
a number is in the range 256 through 999, it is moduloed 256. 
Thus, "~580" is equivalent to CHR$(68). A minus sign is 
treated like any other non-digit character. 

When the metacharacter is followed a quotation mark, that 
quotation mark is not interpreted as a string delimiter. For ex- 
ample, the statement: 



D I S P " Type -•■ " b eg i n n e r •- " o r 



i n ■_ e d • 



displays: 



Type " b eg i n n e r " o r " a d v a n c e d 



Elsewhere, the metacharater is ignored. For example, 

DISP "-■■ ah c" displays a be. 

To include the character ~ in a string, preface it by a 
metacharacter; i.e., * *. 
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BASIC Function 
Keys 



Where possible, BASIC makes the following typing aid as- 
signments to the function keys. Immediate-execute keys 
include a terminating carriage return; pressing the key is 
equivalent to typing the command and pressing (return) . 



BASIC Function Keys 




Key 


Key Label 


Typing Aid 


Immediate 
Execute? 


CD 


LIST 


LIST (without parameters) 


Yes 


CD 


RUN 


RUN (without parameter) 


Yes 


CD 


STEP 


SINGLESTEP 


Yes 


CD 


CONT 


CONT (without parameter) 


Yes 


CD 


SCRATCH 


SCRATCH 


No 


CD 


PRT. IS 


PRINTER IS 


No 


CD 


PLIST 


PLIST 


Yes 


CD 


KEY LAB. 


KEY LABEL 


Yes 


CD 


MS. IS 


MASS STORAGE IS 


No 


GD 


DELETE 


DELETE 


No 


(HD 


LOAD 


LOAD 


No 


CUD 


STORE 


STORE 


No 


CM) 


TR. ALL 


TRACE ALL 


Yes 


CUD 


CRT IS 


CRT IS 


No 


QD 


INIT 


INIT 


Yes 


CEE 


EXIT 


Exits BASIC 


Yes 
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2 



Keyword Dictionary 



A 


M 


B 


N 


C 


O 


D 


P 


E 


R 


F 


S 


G 


T 


H 




1 


U 


K 


V 


L 


w 




X 




Y 
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ABORTIO 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The fl B R T I u statement terminates any interrupt transfer in process and resets the interface 
control lines. For certain interfaces, the data lines are reset. 



( ABORTIO y~ 



interface 
select code 



Item 


Description 


Range 


interface select 
code 


numeric expression, rounded to an integer 


3 through 10 



Examples 

ABORT 10 7 
R B R T I Is c 



Description 

Performing fl B R T I on an interface with an active transfer and EOT branching enabled 
causes the branch to be taken. 

Interface-dependent action: 

■ HP-IB: 

System Controller — sends Interface Clear (IFC) and Remote Enable (REN). 

Active Controller (but not System Controller) — sends Attention (ATN) and My Talk Ad- 
dress (MTA). 

Non controller — stops handshaking data and becomes ready for next operation. 

■ Serial: Turns off all modem control lines (control register 2). 
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...ABORTIO 



■ BCD: Stops handshaking data, sets CTL line false, and places external data lines in high- 
impedance state. 

■ GPIO: Stops handshaking data, sets control lines false, places ports A and B in high-imped- 
ance state, and sets lines from ports C and D to false state. 

■ HP-IL: 

System or Active Controller — sends Interface Clear. 

Non controller — stops current operation and becomes ready for next operation. 

Related Keywords 

HALT, ON EOT, RESET 
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ABS 



Keyboard Executable 
Programmable 

In an IF. ..THEN 



The ABS function returns the absolute value of the numeric argument. 



C^>-*0—* \ ^ZVnt \ —~0)-+ 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 



P o s i t i v e V alue = fl B S (. V a 1 u > 
D I S P BBS ( '...' ar i a b 1 e > 

Related Keywords 

SGH 
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ABSUM 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The RBSUM function returns the sum of the absolute values of the elements in an array. 



(?^M) HTO H a nTm a e y | — KD 



Item 


Description 


Range 


array name 


name of a one- or two-dimensional numeric array 


any valid name 



Examples 

IF flBSUMCflrrayl ) > 1 THEN 2QQ 
fir r aysum = flESUM(fl> 

Related Keywords 

AM FIX, AM IN, CHORM 
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ACS 



Keyboard Executable 
Programmable 

In an IF. ..THEN 



The ACS function returns the arccosine of a numeric argument. 



C^—^Q- H a^nTe^t T — »(>) 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 1 through +1 



Examples 

DISP flCS< . 5> 

Description 

The function returns a REAL number. The value returned depends on the current trigonomet- 
ric mode. In RAD (the default) mode, the value returned is in the range through it radians. 
In DEG mode, the value returned is in the range through 180 degrees. In GRAD mode, the 
value returned is in the range through 200 grads. 

Related Keywords 

COS, DEG, GRflD, RflD 
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ALPHA 



Keyboard Executable 
Programmable 

In an IF. ..THEN 



The R L P H R statement displays the alpha display. When the optional parameters are included, 
the cursor is moved to the specified position. 



(alpha) - 



______ A 

^— * row ' ^"*V ' ) ►column ' 



Item 


Description 


Range 


row 
column 


numeric expression, rounded to an integer and moduloed to a 
value in the range 1 through the number of rows in alpha dis- 
play memory* 

numeric expression, rounded to an integer and moduloed to a 
value in the range 1 through the number of columns in alpha 
display memory* 


>0 
>0 


* The number of rows and columns in alpha display memory is machine-dependent. 



Examples 

ALPHA 
ALPHA 5,7 
ALPHA .50 
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...ALPHA 



Description 

When ALPHA is executed without parameters, the cursor remains in its previous position. The 
lines displayed are the same as were displayed most recently. 

When non-zero parameters are included, the cursor is moved to the specified position. The 
row parameter specifies the row to which the cursor is moved. If necessary, alphanumeric 
display memory scrolls up or down to display the specified row on the bottom or top row of 
the display. 

When ALPHA is executed with a row parameter and no column parameter, the cursor remains 
in the current column. If you designate only the column parameter, the cursor moves to the 
specified column and remains in the current row. 

When either or both parameters is (are) 0, the cursor moves to the upper left corner of the 
current screen. 

Related Keywords 

CURS COL, CURSROW, GRAPHICS 
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AMAX 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The fill FIX function returns the value of the largest element in the specified array. 



(amax) »-(?)- 



array 
name 



o 



Item 


Description 


Range 


array name 


name of a one- or two-dimensional numeric array 


any valid name 



Examples 



N = flMflX(flrray)/iS 

IF flMfiX<Hrrayl> = fiMfiX < fir r ay 2 > THEN 598 



Related Keywords 

AMfiXROW, flMRXCOL, AMI 



2-10 Keyword Dictionary 



AMAXCOL A 



Keyboard Executable 
Programmable 

In an IF...THEH 

The AMAXCOL function returns the column number of the largest element in the array 
specified most recently in an AM FIX function. 



( AMAXCOL ) *- 

Examples 

^Subscript = AMAXCOL 
MAT B = A': , 1 ; AMAXCOL > 

Description 

If two or more elements in different columns have the largest value, the lowest column num- 
ber is returned. 

Related Keywords 

AMAX, AMAXRiDW, AMINCOL, AMIHROW 
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AMAXROW 



Keyboard Executable 
Programmable 

In an IF...THEN 



The AMAXROW function returns the row number of the largest element in the array specified 
most recently in an AM AX function. 



( AMAXROW ) »- 

Examples 

XSubscript = AMAXROW 
MAT B = F\<: 1 : AMAXROW, > 

Description 

If two or more elements in different rows have the largest value, the lowest row number is 
returned. 

Related Keywords 

AM AX, AMAXCOL, AM I WOOL, AM THROW 
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AMIN 



Keyboard Executable 
Programmable 

In an IF...THEM 

The R M I H function returns the value of the smallest element in the specified array. 



(amin) ^T)- 



array 
name 



o-~ 



Item 


Description 


Range 


array name 


name of a one- or two-dimensional numeric array 


any valid name 



Examples 

Y = Fi II I N ( Fi r r a y 2 > 

IF HMIH(flrr ayS>=a THEN 498 

Related Keywords 

AM FIX, flMINROW, fiMINCOL 
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AMINCOL 



Keyboard Executable 
Programmable 

In an IF...THEN 



The R M I H C L function returns the column number of the smallest element in the array 
specified most recently in an AM IN function. 



( AMINCOL ) *- 

Examples 

Y S u b script = fl M I H C L 
MRT B = RC , flHINCOL ; 5> 

Description 

If two or more elements in different columns have the smallest value, the lowest column 
number is returned. 

Related Keywords 

R M fl X C L , fl M fl X R W , AMI N , AMI N R U 



2-14 Keyword Dictionary 



AMINROW 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The AM I HROW function returns the row number of the smallest element in the array specified 
most recently in an fl M I N function. 



( AMINROW ) •» 

Examples 

^Subscript = AMINROW 
MAT B = fl<RMINR0W:3, > 

Description 

If two or more elements in different rows have the smallest value, the lowest row number is 
returned. 

Related Keywords 

RMRXCOL, flMflXROW, AM IN, RMINCOL 
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AND 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The AND operator returns a 1 or based on the logical AND of the operands. 



operand */ AND J *■ operand 



Item 


Description 


Range 


operand 


numeric expression 


— 



Examples 

S=J(1) AND J<2) 
IF S AND P THEN 



U S U B 4 @ 



Description 

A non-zero operand (positive or negative) is interpreted as a logical 1; an operand of zero is 
interpreted as a logical 0. The following table describes the result of performing a logical 
AND. 



Logical AND 


A 


B 


A AND B 














1 





1 








1 


1 


1 



Related Keywords 

EtfOR, HOT, OR 
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AREAD 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The BREAD statement reads characters from the alpha display and copies the characters into 
the specified string variable. 




O 



0-> 



KlH 



beginning 
position 



i r 

V_»/7V-»J ending I ) 
>^_y i position 



<D-> 



Item 


Description 


Range 


string name 


string variable name 


any valid name 


subscript 


numeric expression, rounded to an integer 


1 through 65,530; 
maximum of two 
allowed 


beginning position 


numeric expression, rounded to an integer 


1 through 65,530 


ending position 


numeric expression, rounded to an integer 


1 through 65,530 
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...AHEAD 



Examples 



A R E fl D 
RREflD 
fl R E fi D 



c f " e e n $ 
cree ri f- ( '. 3 ) 
creen$C5] 



Description 

RREflD begins copying characters at the current cursor location. The number of characters 
copied equals the size of the explicitly or implicitly dimensioned string variable, or the number 
of characters in the specified substring. 

Copying preserves the characters just as they appear on the display including leading and 
trailing blanks. The cursor is not copied. 

If the dimensioned size of the RREflD string is larger than the number of characters following 
the cursor in display memory the string is filled with trailing blanks. 



Related Keywords 

ALPHA, A WRIT, OFF CURSOR, ON CURSOR 
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ASN 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The ASH function returns the arcsine of the numeric argument. 



&y^& 



numeric 
argument 



<jy~ 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 1 through +1 



Examples 

Theta = flSN< . ! 
DISP flShKX*' 



Description 

The function returns a REAL number. The value returned depends on the current trigonomet- 
ric mode. In RAD (the default) mode, the value returned is in the range —tt/2 through +7r/2 
radians. In DEG mode, the value returned is in the range —90 through +90 degrees. In 
GRAD mode, the value returned is in the range —100 through +100 grads. 



Related Keywords 



DEi 



:RFiD, RRD, SIN 
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ASSERT 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The ASSERT statement sets and/or clears control lines of the specified interface. 



( assert y 



interface 
select code 



<DM 



byte 



Item 


Description 


Range 


interface select 
code 

byte 


numeric expression, rounded to an integer 

numeric expression, truncated to an integer and 
moduloed 256 


3 through 10 



Examples 

ASSERT 7.; i; 
ASSERT Isc. 



Description 

The binary value of the byte sets or clears the control lines. The action taken is interface 
dependent: 

■ HP-IB — immediately writes the value of the byte to control register 2, regardless of whether 
an I/O operation is in progress. IFC bit (decimal value 128) is ignored. 

■ Serial, BCD, GPIO — immediately writes the value of the byte to control register 2, regard- 
less of whether an I/O operation is in progress. 

■ HP-IL — interrupts the interface and sends a frame using the specified byte and the most 
recent control bits written to register 2. Loop status is not checked before the frame is sent. 



Related Keywords 

ABORT I U, CONTROL 



2-20 Keyword Dictionary 



ASSIGN 



Keyboard Executable 
Programmable 

In an IF...THEH 

The ASSIGN statement assigns an I/O path to an interface or file, or closes an I/O path. 



( ASSIGN y 



J interface I f ~\ ^jT7\ 

~ select code | * \ '" J \^J 



interface 
designator 



o 



*& 



rpc^r 



** selector * \ TO J *\_y~ 



HP-UX 
path name 



K*> 



O 



Item 


Description 


Range 


interface select 


numeric expression, rounded to an integer 


3 through 10 


code 


(see glossary) 




interface 


the interface name (hpib, serial, bed, gpio, hpil) combined 




designator 


with a port designator 




file selector 


numeric expression, rounded to an integer 


11 through 20 


HP-UX path name 


path name of an interface, device, or file 
(see glossary) 


— 



Examples 



IGN 7 TO "hpib" 

IGN 9 TO "ser ial . a£" 

IGN 15 TO "..-■voll..-dir 1 ..- d i r 2 , - m y t i 1 

IGN 7 TO "*" 



Description 

ASSIGN assigns a numeric I/O path to an interface or file. The I/O path assigned to an 
interface is called the interface select code. The I/O path assigned to a file is called the file 
selector. 



Update 1 2/85 
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A ...ASSIGN 



Assigning an Interface Select Code. Each interface in the system must be assigned a 
unique interface select code in the range 3 through 10. If the interface can support only one 
device at a time, the device selector of that device is equivalent to the interface select code. For 
example, if interface select code 8 is assigned to a serial interface, a printer connected to that 
interface has a device selector of 8. 

If the interface supports multiple devices, each device on the interface must have a unique 
primary address. Then, the device selector of each device consists of a combination of the 
assigned interface select code and the primary address of the device: 

[d]d dd 

interface 

select p T ary 
address 
code 

(3-10) (00-31) 



For example, if interface select code 7 is assigned to the HP-IB interface, a plotter with a 
primary address of 05 has a device selector equal to 705. 

Once an interface select code is assigned to an interface, that assignment must be cancelled 
before a new interface select code is assigned to the interface. To cancel an assignment, assign 
the interface select code to // *". For example, the statement ASSIGN 7 TO "$" cancels the 
current interface select code 7 assignment. 

Assigning a File Selector. File selectors in the range 11 through 20 may be assigned to 
BASIC files. More than one file selector may be assigned to a given file. To cancel a file 
selector assignment, assign the file selector to // * ,/ . ASSIGN should not be used to assign an 
I/O path to BASIC-type files. 

Related Keywords 

CRT IS, PLOTTER IS, PRINTER IS 



Update 1 2/85 
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ASSIGN# 



Keyboard Executable I 
Programmable I 

In an IF. ..THEN I 

The R S S I G H # statement opens a BASIC/DATA file by assigning to it a mass storage buffer. 



( A88iaw) -» g;i:| — pnT) 



O 



C name 
HP-U> 
path n 



string 
expression 



-0. 



Or 



Item 


Description 


Range 


file name 


literal; name of a file in the current working directory 


14 characters 
maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name 


— 


buffer number 


numeric expression, rounded to an integer 


1 through 10 



Examples 



IGN# 1 TO "myfile" 

I G N # 19 TO "syste m / a c c o u n t i ng ,-- m a y 



TO ft$ 
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A ...ASSIGN# 



Description 

If the file name is used alone (rather than as part of an HP-UX path name), the file must be in 
the current working directory. 

A data file must be opened before it can be accessed. Once a buffer is assigned to a file, it 
remains associated with that file until the file is closed. When a file is opened, the file pointer 
is placed at the beginning of the file. 

A file can be closed by: 

■ Executing fi S S I G N tt buffer number T * . 

■ Assigning its buffer to another file. 

The following operations cause data to be transferred from the buffer to the disc: 

■ The buffer becomes full. 

■ The file is closed. 

■ Program execution is halted. 

■ A new logical record located in a new disc block is accessed using a random access 

PRIHTtt. 

■ A PRIHTtt statement is executed from the keyboard. 

Related Keywords 

PRIHTtt, REfiDtt 
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ATN 



Keyboard Executable 
Programmable 

In an IF...THEH 



The flTN function returns the arctangent of the numeric argument. 



(T^Q— K^y— H a n n U g m u e : e n C t j — <>) 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 

Theta = RTN< 1 > 
DISP RTN<fl> 

Description 

The function returns a REAL number. The value returned depends on the current trigonomet- 
ric mode. In RAD (the default) mode, the value returned is in the range —tt/2 through x/2 
radians. In DEG mode, the value returned is in the range —90 through 90 degrees. In GRAD 
mode, the value returned is in the range —100 through 100. 

Related Keywords 

DEG, GRflD, RHD, TflH 
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ATN2 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The RTN2 function returns the arctangent of Y/X in the proper quadrant. 



(ATN2) — >^T) — - 



argument 



o 



argument 



-©— 



Item 


Description 


Range 


argument Y 
argument X 


numeric expression 
numeric expression 


— 



Examples 

Theta=flTN2<4^3> 

D I S P R T N 2 (. P o i n t Y , P o i n t X > 

Description 

The function returns a REAL number. The value returned depends on the current trigonomet- 
ric mode. In RAD (the default) mode, the value returned is in the range —tt through ir 
radians. In DEG mode, the value returned is in the range —180 through 180 degrees. In 
GRAD mode, the value returned is in the range —200 through 200. 



Related Keywords 

FiTN, DEG, GRRD, RflD, TP.I 



2-26 Keyword Dictionary 



AUTO 



Keyboard Executable ■ 
Programmable □ 

In an IF... THEN □ 



The FiUTO command provides automatic line numbering during program entry. 



(auto)- 



L ^ beginning line 



k>n 



increment 



Item 


Description 


Range 


beginning line 
number 

increment 


integer constant (default =10) 
integer constant (default=10) 


1 through 65,535 
1 through 65,535 



Examples 

fl U T 5 

fi U T 100,2 
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A ...AUTO 



Description 

Executing AUTO displays the specified beginning line number. When that line has been en- 
tered, a new line number, computed by increasing the current line number by the increment, 
is displayed. 

Automatic line numbering is halted by pressing (return) in response to a new line number.* 

Related Keywords 

NORMAL 



: Pressing ( RETURN ) immediately after a line number does not delete that line. For example, typing 1 a @ ( RETURN ) does not 
delete line 100. 
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AWRIT 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The fl W R I T statement displays the specified string at the current cursor location on the alpha 
display. 



(awrit)- 



str ing 
expression 



Item 


Description 


Range 


string expression 


— 


— 



Examples 

FiWRIT String* 
AWRIT String*':: 



>C 1 , 18II& 



Description 

The string copied to the display by AWR I T can be up to 65,530 characters in length. If neces- 
sary, the alphanumeric display scrolls to display the string as it is being copied. If the string is 
shorter than the size of display memory, FiWRIT has no effect on cursor position — the cursor 
remains positioned at the first character of the AWRIT string. If the string is longer than the 
size of alphanumeric display memory, lines are lost from the top of display memory and the 
cursor is moved to home position (1,1). 

Related Keywords 

ALPHA, AREflD 
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AXES 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The AXES statement draws a pair of axes with optional major and minor ticks. 





x-major |_ to /"^\_J y-majo 
count \*L/ count 



.. fc /0\ J niajor ti 
^V^r l size 



Item 


Description 


Range 


x-tick spacing 


numeric expression, interpreted in the current units 
■(deTaTnt^TJHTo~Tteks)~- cL kwA+ •— /Q 4\ti± p'r^Ki' $ 


— 


y-tick spacing 


numeric expression, interpreted in the current units 
(default = 0, no ticks) 


— 


x-intersection 


numeric expression, interpreted in the current units 
(default = lower-left corner) 


— 


y-intersection 


numeric expression, interpreted in the current units 
(default = lower-left corner) 


— 


x major count 


numeric expression, rounded to an integer, specifying the 
number of tick intervals between major tick marks on the 
x axis (default=1) 




y major count 


numeric expression, rounded to an integer, specifying the 
number of tick intervals between major tick marks on the 
y axis (default = 1) 




major tick size 


length of a major tick, in graphics units (default = 2) 


— 
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...AXES 



Examples 

AXES 1,2 

fl X E S 1,2, X < I > , ' i ' ( I > 

fl X E S 1,2,48,29,3,6 

Description 

The axes are drawn across the entire plotting area using the current line type. Tick marks are 
drawn symmetrically from the intersection of the two axes such that a major tick mark on 
each axis corresponds with the origin. 

The x- and y- tick spacing parameters specify the distance between tick marks on each axis. 
Negative numbers are interpreted as positive values by taking the absolute value. Thl Tdef auTP 
value of draws no ticks^> 

The x-intersection parameter specifies, in current x-axis units, the point where the x-axis inter- 
sects the y-axis. The y-intersection parameter sepcifies, in current y-axis units, the point where 
the y-axis intersects the x-axis. 

The x- and y- major count parameters specify the number of intervals between major ticks. 
For example, a major count of 4 means that every fourth tick is a major tick. The default value 
of one draws each tick as a major tick. 

The major tick size parameter specifies the length of the major ticks in graphics units. The 
default length is 2 GU's. Minor ticks are always Vi the size of major ticks. 

Related Keywords 

GRID, LINE T V P E, L Fi X E S, L G R I D, X fl X I S, V fl X I S 
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BEEP 



Keyboard Executable ■ 
Programmable ■ B 

In an IF...THEN ■ 

The BEEP statement produces an audible tone. The pitch and length parameters are ignored if 
the system is not capable of producing variable tones. 



(beep) - 



"-^pitchx — *\ ' ) — *" length* ' 



Item 



Description 



Range 



pitch* 
length* 



numeric expression, rounded to an integer 
numeric expression, rounded to an integer 



The ability to change frequency and duration of the tone and the interpretation of BEEP parameters are machine-dependent. 



Examples 

BEEP 

BEEP 109,120 
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BINAND 



Keyboard Executable ■ 
B Programmable ■ 

In an IF. ..THEN ■ 

The B I H fl H D function returns the bit-by-bit AND of the binary representation of two integer 
arguments. 



( BINAND ) KD" 



numeric 
argument 



^7\ I numeric I ^/T^ 
*\^ ^ argument | \J^/ 



Item 


Description 


Range 


numeric argument 


numeric expression, rounded to an integer 


range of integers 



Examples 



*: = BINflNCKrU 1 > , 31 
II ISP BINflND<4X#2, V 
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...BINAND 



Description 

The arguments are represented as two's complement integers. The results of each bit-by-bit 
AND are used to construct the integer returned by the function. Each bit is computed accord- 
ing the following truth table. 



B 



Logical AND Used in BINAND 




Argument #1 


Argument #2 


Result 














1 





1 








1 


1 


1 



Related Keywords 

BINCriP, BINEOR, BINIOR, BIT 
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BINCMP 



Keyboard Executable ■ 
B Programmable ■ 

In an IF. ..THEN ■ 

The BINCMP function returns the binary complement of an integer. 



( BINCMP ) Kj}" 



numeric 
argument 



~<D-~ 



Item 


Description 


Range 


numeric argument 


numeric expression, rounded to an integer 


range of integers 



Examples 

Tt lag=BINCMP(Z> 
DISP BINCMP<2X+4> 



Description 

The argument is represented as a two's complement integer. Each bit of the result is the in- 
verse of the corresponding bit in the argument. If the argument is smaller than the number of 
bits per integer, leading zeros are assumed. 

Related Keywords 

B I HAND, BINE OR, BIN I OR, BIT 
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BINEOR 



Keyboard Executable ■ 
Programmable ■ B 

In an IF... THEN ■ 

The B I N E R function returns the bit-by-bit exclusive OR of the binary representation of two 
integer arguments. 



C^^> — <()— H ^ZVn't | KTO H a^u^t | — <)) 



Item 


Description 


Range 


argument 


numeric expression, rounded to an integer 


range of integers 



Examples 



fi = BIHEOR<S< 1 > , S<12> > 
DISP BINE0RC2X,6) 
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...BINEOR 



B 



Description 

The arguments are represented as two's complement integers. The result of each bit-by-bit 
exclusive OR is used to construct the integer returned by the function. Each bit is computed 
according the the following truth table. 



Exclusive OR Used in BINEOR 



Argument #1 


Argument #2 


Result 














1 


1 


1 





1 


1 


1 






Related Keywords 

B I HAND, BINCMP, BINIOR, BIT 
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BINIOR 



Keyboard Executable ■ 
Programmable ■ B 

In an IF. ..THEN ■ 

The B I N I r function returns the bit-by-bit inclusive OR of the binary representation of two 
integer arguments. 



( BINIOR ) »"(D~ 



numeric 
argument 



o- 



numeric 
argument 



<>> 



Item 


Description 


Range 


numeric argument 


numeric expression, rounded to an integer 


range of integers 



Examples 



J ISP B I N I R ■:: X < 1 > , C < 1 > '■> 

IF BINIOR (B, 1 >=8 THEN 2@9 
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...BINIOR 



B 



Description 

The arguments are represented as two's complement integers. The result of each bit-by-bit 
inclusive OR is used to construct the integer returned by the function. Each bit is computed 
according the the following truth table. 



Inclusive OR Used in BINIOR 




Argument #1 


Argument #2 


Result 














1 


1 


1 





1 


1 


1 


1 



Related Keywords 

BINflND, BINCMP, BIHEOR, BIT 
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BIT 



Keyboard Executable 
Programmable 

In an IF. ..THEN 

The BIT function returns the value (0 or 1) of the specified bit of the argument. 



■ B 



GeD—O 



numer ic 
argument 



-OH 



bit 
position 



<D— 



Item 


Description 


Range 


numeric argument 
bit position 


numeric expression, rounded to an integer 

numeric expression, rounded to an integer, indicating which 
bit is returned 


range of integers 

1 through the 
number of bits per 
integer 



Examples 

Flag l=BIT(fl< 1 > , 0> 

IF BITCRl , 15;' = 1 THEN R1*="0N" 

Description 

The argument is represented as a two's complement integer. Bit is the least significant bit. 

Related Keywords 

BIMfiMD, BINCMP, B I HE OR 
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BPLOT 



Keyboard Executable ■ 
B Programmable ■ 

In an IF...THEN ■ 

The BPLOT (byte-plot) statement plots groups of dots onto the graphics display. 



(W>— H^rTnr h -»Q 



bytes per 
row 



Item 


Description 


Range 


byte-plot string 
bytes per row 


string expression 

numeric expression, rounded to an integer 


non-displayable 
characters must 
be specified using 
CHR$ or a 
metacharacter 
sequence 

even numbers 
only, cannot ex- 
ceed width of the 
display* 


* The number of raster dots per row is machine-dependent. The maximum bytes per row equals the number of raster dots per 
row divided by 8. 



Examples 

BPLOT "Qh,j@", 
BPLOT Rtt"ll( 



:HR*< 122) . H 
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...BPLOT 



Description 



The display must be the current PLOTTER IS device; byte-plotting cannot output to a periph- 
eral plotter. An error occurs if any portion of the byte-plot is out-of-bounds. 

BPLOT starts plotting at the current pen position and plots across rows of dots from left to 
right. Each character (byte) in the byte-plot string specifies the pattern of eight display dots. 
The binary equivalent of each character determines which of the plotted dots are on (1) and 
off (0). 

The bytes per row determines how many characters are plotted on a row. When the specified 
number of characters are plotted, the pen moves to the next row, and plotting continues with 
the next character in the byte-plot string. The sign of the bytes per row parameter determines 
how BPLOT dots interact with existing dots. If the parameter is positive, B P L T performs an 
exclusive OR with existing dots. When the parameter is negative, new BPLOT dots overwrite 
existing dots. 

BPLOT writes to the display two bytes at a time. The bytes per row parameter must be an 
even number. No error is returned for odd numbers, but the byte-plot string is not interpreted 
properly. 

At the conclusion of the byte-plot, the pen is moved to the next row of dots, directly beneath 
the left-most dot just plotted. 

BPLOT Interaction With Exisiting Dots 



BPLOT Dot 
(as specified in 
byte-plot string) 


Existing Dot 
(on the display) 


New Dot on the Display 

Positive Bytes Per 

Row Parameter Negative Bytes Per Row 
(EXOR) 




1 
1 



1 

1 



1 
1 






1 
1 



Related Keywords 

BREAD 



B 
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BREAD 



Keyboard Executable ■ 
B Programmable ■ 

In an IF... THEN ■ 

The BREAD (byte-read) statement reads groups of eight dots from the graphics display, con- 
verts each group of eight dots to a character, and stores the characters in the specified string 
variable. 



(brI*d)-^^ 



Item 


Description 


Range 


string name 


name of a simple string variable or string array element 


any valid name 


bytes per row 


numeric expression, rounded to an integer 


even numbers 
only, cannot ex- 
ceed width of the 
display* 


* The number of raster dots per row is machine-dependent. The maximum bytes per row equals the number of raster dots per 


row divided by 8. 



Examples 



BREAD fl * , 3 

BREAD String *<3>. N 
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...BREAD 



Description 

The display must be the current PLOTTER IS device. Byte-reading cannot address a peripheral 
plotter. 

BRER D starts reading at the current pen position, and reads across the row of dots from left to 
right. Each group of eight dots is converted to a character based on the binary equivalent of 
each character in the computer character set. When a dot is on, it is read as 1. 

The bytes per row determines how many characters are read on a row. When the specified 
number of characters has been read, the pen moves to the next row, and byte-reading contin- 
ues. At the conclusion of the byte-read, the pen is moved to the next row of dots, underneath 
the left-most dot read most recently. 

BREAD reads the display two bytes at a time. The bytes per row parameter must be an even 
number. No error is returned for odd numbers, but the byte-read string will contain incorrect 
data. 

The BREAD string can contain characters with decimal codes in the range through 255. If the 
contents of the string are to be displayed (on the alpha display) or printed, the characters with 
decimal codes in the range through 31 should be converted to their decimal codes (using 
HUM) to avoid unpredictable display or printer activity. 

Related Keywords 

BPLOT 



B 
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BTD 



Keyboard Executable ■ 
B Programmable ■ 

In an IF... THEN ■ 

The BTD (binary-to-decimal) function interprets the string argument as the binary representa- 
tion of a number and returns the numeric decimal equivalent. 



GzD — <D — - 



string 
argument 



-0— 



Item 


Description 


Range 


string argument 


string expression containing the base 2 representation of an 
integer 


O's and 1's only; 
cannot exceed the 
range of integers 



Examples 



Y=BTD<H*)+X 

DISP BTD ("11919000") 



Related Keywords 



DTB*, DTH*, DTO*, HTD, OTD 
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CALL 



Keyboard Executable D 
Programmable ■ 

In an IF...THEH ■ 



The CALL statement transfers program execution to the specified subprogram and, optionally, 
passes parameters into the subprogram. 



(W- 



O 



subprogram 
name 



HP-UX 
path name 



string 
expression 



o 



^~*\}_J ** parameters \Ss 



pass parameters 



o 



var iable 
name 



passed 



^^i^r^ 



by address a 



o 



simple variable 
name 



■G> 



array 
element 



numeric 
constant 



CXJEEEJD 



arithmetic and/or 
relational expression 



- passed by value 
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Item 


Description 


Range 


subprogram name 


literal; name of a BASIC/SUBP file in the current working 


14 characters 




directory 


maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a subprogram name or HP-UX path 
name 


— 


simple variable 


name of a simple numeric or string variable 


any valid name 


name 






array element 


element of a numeric or string array 


— 


numeric constant 


none 


— 


literal 


string constant containing keyboard characters, the CHR$ 
function, and/or metacharacter sequences 


— 


arithmetic or rela- 


expression containing variables and/or constants, along with 


— 


tional expression 


arithmetic or relational operators 





Examples 



CALL Solstice" 

CfiLL "SUB#1" < Number .String*, fir ray *0,Element*<3, 7 >C4, 93, fl*B^2> 

CALL 'VDl^D2^SUBi"<<a>) 
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...CALL 



Description 

The CALL statement searches system memory and, if necessary, the current working directory 
or specified mass storage location, for the designated subprogram. The HP-UX path name 
must be used if the subprogram file is located elsewhere than computer memory or the cur- 
rent working directory. When the subprogram is found (and, if necessary, loaded), execution 
begins. 

There are three ways to pass parameters between the calling (sub)program and the called 
subprogram: 

■ The variables can be included in COM statements in the main program and one or more 
subprograms. Changes in the values assigned to these variables are returned to the calling 
program. Numeric and string constants cannot be transferred this way. 

■ Parameters can be passed by address. The declared precision of numeric variables accompa- 
nies them into the subprogram. Changes in the values assigned to the variables are returned 
to the calling program. Entire arrays can be passed this way; individual elements of arrays 
cannot be passed. When an array is passed to a subprogram, the option base of the program 
and subprogram must agree. 

■ Parameters can be passed by value. Changes in the values assigned to the variables are local 
to the subprogram; they are not transferred back to the calling program. Individual ele- 
ments of arrays can be passed this way; entire arrays cannot be passed unless they are 
specified element by element. Numeric and string expressions can be passed by value. 

Parameters are passed in the order in which they appear, left to right. The CALL statement 
can contain fewer parameters than the SUB statement of the subprogram it calls. Optional 
parameters are listed following the required parameters. The number of parameters passed 
into the subprogram is returned by the NPflR function. At the beginning of subprogram execu- 
tion, unfilled numeric parameters are set to 0, type REAL; unfilled string parameters are set to 
the null string. 



Keyword Dictionary 2-49 



...CALL 



Certain system properties are global; they are passed between the main program and subpro- 
grams. Other properties are local — known only to the program or subprogram in which they 
are set or enabled. The following declarations are local; all others are global: 



Local Properties 




OFF 


EOT <— OH 


EOT 


OFF 


ERROR < — ► 


H ERROR 


OFF 


IHTR <— 


H 


IHTR 


OFF 


KEY# <— 


OH 


KEY* 


OFF 


KYBD <— 


OH 


KYBD 


OFF 


TIMEOUT 


«-- 


► OH TIMED 


OFF 


TIMERtt « 


--#■ 


OH TIMERtt 



JT 



When S U B E H D or S U B E X I T is executed, program execution returns to the statement immedi- 
ately following CALL. Subprograms cannot be invoked by event-initiated branching. 

Refer to the table of Reset Conditions for additional information. 

Related Keywords 

COM, FIHDPROG, HPRR, STORE, SUB 
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The ChLLBIH statement calls a binary entry point. 



CALLBIN 



Keyboard Executable 
Programmable 

In an I F...THEN 



(cALLBIN W-^f ^ ent 7 am P e° int H^-I 



string 
expression 



pass 
parameters 



pass parameters 



o 



variab le 
name 



^^i^r^ 



passed 
by address ii 



<s> 



simple variable 
name 



o 



array 
element 



numeric 
constant 



-CEEEOD 



arithmetic and/on 
relational expression 



passed by value 
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Item 


Description 


Range 


entry point name 


literal; name of an entry point 


«£16 characters 


string expression 


expression evaluating to an entry point name 


— 


pass parameters 


(see diagram) 


— 


simple variable 


name of a simple numeric or string variable 


any valid name 


name 






array element 


element of a numeric or string array 


— 


numeric constant 


none 


— 


literal 


string constant containing keyboard characters, the CHR$ 
function, and/or metacharacter sequences 


— 


arithmetic or rela- 


expression containing variables and/or constants, along with 


— 


tional expression 


arithmetic or relational operators 





Examples 

CRLLBIN R* 

CRLLB I N "drawpatter n " < R < ) , ( B > , C* , D ( 4 , 5 ) , 2E 1 2 , " abcde " ., 4*R ) 

Description 

The binary program must have been previously loaded with L fl D B I N or by invoking the 
configuration file .bconfig. If duplicate entry point names are present, the first entry pointed 
retrieved into memory is executed. 

Execution of BASIC resumes at the statement following CRLLBIN. 

The following rules and procedures apply only to simple binary programs. Simple programs 
are diffentiated from more complex binaries in that they make no references to BASIC — all 
communication with BASIC is through pass parameters listed in CALLBIN. 
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...CALLBIN 



Passing BASIC Variables Into Binaries. The following rules apply to CALLBIN pass 
parameters: 

■ Variables can be passed from BASIC by address or by value (see syntax diagram). The 
routine to which the BASIC variables are passed must provide the proper formal 
parameters. 

■ The precision of BASIC variables should match binary declarations. In "C", for example, 
INTEGER variables and integer constants become type int; REAL and SHORT variables, 
and all numeric expressions except integer constants, becomes type double. 

■ Strings must be dimensioned in BASIC before they are passed to the formal parameters. A 
character (null string is permissible) should be assigned to the last character position in the 
string. This ensures that the entire dimensioned length of the string will be recognized by 
BASIC when parameters are passed back to it. For string arrays, the array must be dimen- 
sioned, and a character should be assigned to the last position of each element in the array. 

■ Array dimensions must be dimensioned in the binary to be the same as in the BASIC pro- 
gram. The BASIC option base should be 0. 

Compiling and Loading Simple Binaries. When the binary is written, the following proce- 
dure compiles it: 

1. Compile the binary program into and object file. Refer to your language documentation 
for further information. (For "C", compile using the "-c" option. This creates a compiled 
\o" file.) 

2. Execute the HP-UX Id command, using the object file as the input file. Use the "-x" and 
"-6" options to retain relocation information and space allocated for common variables. If 
the binary uses any library routines, include the appropriate Id parameter to load them. 
(Refer to the HP-UX Reference documentation.) 

3. The output file specified in the Id command now contains the complete, compiled binary. 
The binary can be loaded using LOADBIN or by using the .bconfig (BASIC configura- 
tion) file. 

The .bconfig file contains a list of binary programs to be loaded whenever BASIC is invoked. 
The binary programs are listed one per line. BASIC and .bconfig must be in the same 
directory. 

Related Keywords 

CALL, LOflDBIH, SCRRTCHB I H 
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CAT 



Keyboard Executable 
Programmable 

In an IF...THEH 



The C R T statement displays the contents of the specified directory or the directory information 
associated with a particular file. 



(™> 



-o 



file 
name 



HP-UX 
path name 



J 



o~ 



string 
express ion 



Item 


Description 


Range 


file name 


literal; name of a file in the current working directory 


14 characters 
maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name 


— 



Examples 

CRT Wo 11" 
CAT "voll..--dir 



Description 

The output from CRT depends on whether the file is a directory or non-directory file, and 
whether the non-directory file was created in BASIC or elsewhere. 
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...CAT 



Cataloging Directory Files. When the specified file is a directory, CRT displays the path to 
the specified directory (as specified in the CAT parameter) and a list of the directory contents. 
The directory entry for each file contains the following information: 

■ name — the file name. 

■ size — the size of the file in bytes. 

■ type — directory, text/data, fifo/pipe, or device. 

■ permission — read, write, read/write, or none. 

■ date modified — the date the file was last modified. 

When C R T is executed without parameters, the contents of the current working directory and 
the directory's absolute path name are listed. Files with file names beginning with a period 
will not be listed. 

Cataloging BASIC Files. When the specified file is a BASIC file, CAT displays the following 
information about the file: 

■ name — the file name. 

■ bytes — the number of bytes per file record. 

■ recs — the number of records in the file. 

■ blocks — the number of blocks occupied by the file. 

■ type— BASIC/DATA, BASIC/PROG (program), BASIC/SUBP (subprogram), BASIC/GRAF 
(graphics). 

■ date modified — the date the file was last changed. 

If the file name is used alone rather than as part of an HP-UX path name, the file must be 
located in the current working directory. Files beginning with a period will be listed. 

Cataloging Non-BASIC Files 

If the specified file is not a directory and is not a BASIC-type file, the catalog consists of a file 
header followed by one line one line containing the name, size, type, permission, and date 
modified. 
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CEIL 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The CEIL function returns the smallest integer greater than or equal to the numeric argument. 



(S)— <(>- H a^rn^t | — CT> 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 

T=CEIL OO 
Rc.undUpX = CEILOO 



Description 

The CEIL and IP functions return the same result for negative arguments. 

Related Keywords 

IP, INT 
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The CFLflG statement clears the specified flag. 



CFLAG 



Keyboard Executable 
Programmable 

In an IF. ..THEN 



(cflag)- 



numenc 
expression 



Item 


Description 


Range 


flag number 


numeric expression, rounded to an integer 


+ 1 through +64 



Examples 

CFLflG 25 

IF X#4 then CFLflG 2*1 

Description 

The CFLflG statement clears one flag at a time. SFLflG is used to clear from 1 to the entire 64 
flags at once. 

All flags are cleared when RUN, I HIT, or CHAIN is executed. 



Related Keywords 

FLAG, FLAG*, SFLflG 
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CHAIN 



Keyboard Executable D 
Programmable ■ 

In an IF...THEN ■ 

The C H fl I H statement scratches the current BASIC program, retrieves the specified 
BASIC/PROG file, and starts program execution. 



( CHAIN} - 



O 



file 
name 



HP-UX 
path name 



J 



o 



string 
expression 



Item 


Description 


Range 


file name 


literal; name of a file in the current working directory 


14 characters 
maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name 


— 



Examples 



HfllH "Filename" 
HflIN FILE* 
HflIN 'VDiri/Dir 



f i len a m e 
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Description 

If the file name is used alone (rather than as part of an HP-UX path name), the file must be in 
the current working directory. 

When a program is chained into memory: 

■ All variable assignments are scratched except those declared in common by C M statements 
in the calling program and chained program. 

■ Assignments made to the user-defined keys by the previous program are scratched. 

■ Event-initiated branches (ON ERROR, ON TIMERtt, ON KEY#, ON KYBD, ON TIMEOUT, 
ON INTR, ON EOT,) are disabled. 

■ Binary programs in memory remain intact. 

■ Program flags are cleared. 

■ All subprograms in memory are scratched. 

Refer to the table of Reset Conditions on pages 4-8 and 4-9 for additional information. 

Related Keywords 

COM 
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CHECK READ# 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The CHECK READ* statement enables and disables verification of data printed to the disc. 



(check) — I *» (bead# )- 



K 



READ OFF* 



? 



buf f er 
number 



Item 


Description 


Range 


buffer number 


numeric expression, rounded to an integer 


1 through 10 



Examples 



HEi 
HEi 
HEi 



K READ* 1 

K R E fl D # B u f t e r H u m b e r 

K READ OFF* 1 



Description 

When check read is enabled, the system performs an immediate read-after-write whenever 
data is transferred from the specified buffer to the disc. If a byte-by-byte comparision detects 
a difference, an error is returned. 

Check read is disabled by executing CHECK READ OFF*. 

Related Keywords 

PRINT* 



2-60 Keyword Dictionary 



CHR$ 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The CHR$ function converts a numeric value into a string character according to the machine 
character set. 



(CHR$) «*(7) •» 



numeric 
expression 



■O 



o£ 



^-*> literal ' 



■<~> 



digit 
sequence 



o 



Item 


Description 


Range 


numeric argument 


numeric expression, rounded to an integer and moduloed 256 
to evaluate within the range through 255 


numbers outside 
the range 
-32,767 through 
+32,767 are in- 
terpreted as 255. 



Examples 



PRINT fi,B,CHR*<13>, C 

IF fi*CX J XD=CHR*<10) THEN 31 



Description 



CHR* can be used to include non-displayable characters and quotation marks in literals. (The 
metacharacter, ~, can also be used. Refer to page 1-11). 

Related Keywords 

HUM 
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CLEAR 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

When executed without a decive selector, the CLEAR statement clears the contents of the al- 
pha display. When a device selector is specified, C L E fl R clears the specified interface or resets 
** the peripheral device. 



(clear)- 





r\^ 


. 


. 1 


r 


\u^ 


> 


-< 


1 % 


dev ice 
selector 













Item 


Description 


Range 


device selector 


numeric expression, rounded to an integer (see glossary) 


— 



Examples 

CLEAR 785 

CLEAR I sc * 1 S +D 1 , Is c 

Description 

CLEAR Without Parameters. When CLEAR is executed without parameters, it clears all of 
alpha display memory and moves the cursor to home position (1,1). 
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CLEAR With Parameters. If two or more device selectors are specified, they must be valid 
combinations of the interface select code and primary address. The devices must be at the 
same select code. 

The following interface-dependent action is taken: 

■ HP-IB and HP-IL (must be active controller): 

If the device selector is an interface select code, then Device Clear (DCL) is sent. 

If the device selector contains a primary address, then Unlisten (UNL), Listen 
Address(es)(LAD), and Selected Device Clear (SDC) are sent. 

HP-IB leaves ATN true; use RESUME to set ATN false. 

■ GPIO: 

If the device selector is an interface select code, the interface pulses RES A and RESB. 
If the device selector contains an even primary address, the interface pulses RESA. 
If the device selector contains an odd primary address, the interface pulses RESB. 

■ Serial, BCD: Error. 

Related Keywords 
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CLIP 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The CLIP statement specifies plotting boundaries (the soft clip area) in the current scale units. 



(clip) - 



^-^ x-min +4 i J »> x-max *4 $ J »• y-min ^ » J »■ y-max ' 



Item 


Description 


Range 


x min 


numeric expression, interpreted in current units 


— 


x max 


numeric expression, interpreted in current units 


— 


y min 


numeric expression, interpreted in current units 


— 


y max 


numeric expression, interpreted in current units 


— 



Examples 



C LIP 9 , 5 , 8 , 1 

C LIP 1 * D . 10 * D +50. 0.1 
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Description 

The CLIP parameters, expressed in current units, define the boundaries of the plotting area. 
These boundaries replace any previously established plotting boundaries. No lines can be 
drawn beyond the plotting boundaries, but labels can be drawn outside the plotting area and 
within the graphics limits. 

Executing C LIP without parameters provides for digitizing the plotting boundaries. Program 
execution halts until two corners of the boundaries are entered from the plotting device. 

The plotting area defined by CLIP cannot be scaled by SCALE, M SCALE, or SHOW. When a 
scaling statement is executed after a C L I P statement, the new user units are mapped onto the 
LOCATE plotting area or onto the graphics limits. 

Plotting boundaries set by CLIP are canceled when LIMIT, PLOTTER IS, or UNCLIP is 
executed. The S E T G U statement deactivates the plotting boundaries; they are restored by exe- 
cuting SETLIU. 

Related Keywords 

LOCATE, UNCLIP 
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CNORM 



Keyboard Executable 
Programmable 

In an IF...THEH 



The CNORM function returns the column norm of an array. The column norm is computed by 
summing the absolute values of the elements in each column of the array and selecting the 
** largest sum. 



(»)— H^(>— H ^ | ~ +0) 



Item 


Description 


Range 


array name 


name of a one- or two-dimensional array 


any valid name 



Examples 

SUM=CNORM<flrrayl > 

IF CNORM (fl;'i CNORM. ::b> THEN Y = CHORM ■:! fl > 

Related Keywords 

fiBSUM, CNORM COL, FNORM, RNORM 
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CNORMCOL 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The C N R M C L function returns the column number of the column having the largest sum of 
absolute values, using the array specified in the most recently executed CHORM function. 

C 



(cnormcol)- 



Examples 

M H T B = MAT R C , C H R M C L > 

fl r r a m 1(3, C H R M C L > = 



Related Keywords 

FIB SUM, CHORM 



Keyword Dictionary 2-67 



COM 



Keyboard Executable D 
Programmable ■ 

In an IF...THEH □ 

The COM statement dimensions variables, reserves memory for them, and preserves variable 
assignments when chaining programs or calling subprograms. 



( com y 1 - 



O 



-» (real) - 

-» (sH0Rt) - 



< 



INTEGER 



numeric 
name 



string 
name 



o. 



W^> ± 4ssT - u 6> J 




O^ 



upper 
bound 



o 



rKDHIlHjH 



Item 


Description 


Range 


numeric name 
upper bound 
string name 
string length 


name of a simple numeric variable or numeric array 
integer constant 

name of a simple string variable or string array 
integer constant 


any valid name 
1 through 65,530 
any valid name 
1 through 65,530 



Examples 



1 @ C U M N u rn b er,fl r r a y >■. 3 , i 6 ':> . S tri ng * ., S H r r a y $ < 1 2 > L3&1 
300 COM REAL fl , B < 5 > , I NTEGER I < 50 > , d* 
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Description 



COM declares variables to be held "in common" between programs and subprograms. When a 
variable is held in common, its precision (REAL, SHORT, or INTEGER), properties (array lower 
and upper bounds, string length), and assigned value are preserved. 

COM has two purposes: q 

■ To preserve variables during program chaining. When a program chains another program, 
all program variables are scratched except those held in common. 

■ To pass variables between a program and a subprogram. 

Common variables are scratched by executing RUN, INIT, or SCRATCH. 

When variables are held in common, matching C M statements must appear in the originating 
program and the (sub)program (accessed by CHR I N or CALL). Variables held in common must 
agree in type (numeric versus string, simple versus array), precision, option base, upper 
bound, and maximum string length. When precision is not specified, the variable is assumed 
to be REAL. All string variables must include an explicitly dimensioned string length. 

When COM includes one or more precision declarations, all numeric variables following the 
declaration have that precision until another declaration is encountered. 

A (sub)program can have any number of COM statements. However, the same variable cannot 
appear in more than one COM statement. The variable names need not match between 
(sub)programs. Variable assignments and properties are passed based on the order in which 
they appear in the (sub)program's COM statement(s). 

If an P T I N B fl S E statement is used in a program, it must appear before any C M state- 
ments. If one or more arrays are held in common during chaining, the option base of the two 
programs must agree. Likewise, the option base of a program and subprogram must agree if 
arrays are passed into the subprogram. 

A COM statement cannot be included within a function definition. COM cannot be used to pass 
numeric and string constants to subprograms. 

Related Keywords 

DIM, INTEGER, REAL, SHORT 
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CONT 



Keyboard Executable ■ 
Programmable D 

In an IF...THEN □ 

The CONT command resumes execution of a program at the specified line after it has been 
paused. 



(™D- 



Item 


Description 


Range 


line number 


integer constant identifying a program line (default = next 
program line) 


1 through 65,535 



Examples 

C H T 1 

Description 

Executing CONT without a line number causes program execution to resume at the line at 
which execution was paused. When a line number is specified, execution resumes at that line 
in the current program or subprogram. If the specified line number does not exist, execution 
resumes at the next higher-numbered line. 

When a program is continued, variables retain their current values. If a program is edited 
while paused, it cannot be continued. Instead, it must be run. 

Related Keywords 

IHIT, PR USE, RUN 
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CONTROL 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The CONTROL statement writes one or more bytes of data to interface registers or I/O buffer 
registers. 



( CONTROL )- 



interface 



o 



select code I x^ 
I/O buffer I J 



register 
number 



o 



^fT \ ' f ^1 control 
\l/ ^ H byte 



Item 


Description 


Range 


interface select 
code 

I/O buffer name 

register number 

control byte 


numeric expression, rounded to an integer 

name of string variable declared an I/O buffer 
numeric expression, rounded to an integer 
numeric expression, rounded to an integer 


3 through 10 

through 23 
through 255 



Examples 



CONTROL 7,16.1 3 

CONTROL 1,17; C < 1 > , C < 2 > , C < 3 > 

Description 

The register number specifies the first register to be used. If more than one control byte is 
listed, the values are written to consecutive registers. The binary equivalent of each control 
byte sets and clears bits in the regis ter(s). 

Related Keywords 

ASSERT, ENABLE INTR, STATUS 
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CONVERT 



Keyboard Executable 
Programmable 

In an IF...THEH 



The CONVERT statement enables or disables a specified character conversion table to be used 
during ENTER and OUTPUT operations. 



( CONVERT )-[-»»( IN ) 



K 






interface 
select code 



I/O buffer 
name 



*)-J 



^(iNDEX^ 



rj 



Item 


Description 


Range 


interface select 
code 

I/O buffer name 

string name 


numeric expression, rounded to an integer 

name of a string variable previously declared as an I/O buffer 
name of string variable containing the conversion table 


3 through 10 



Examples 

CONVERT IN " 
CONVERT OUT 



PAIR S : fl $ 
' INDEX: B* 



Description 

C N V E R T converts incoming or outgoing data exchanged via a specified I/O path — an inter- 
face (interface select code) or I/O buffer (I/O buffer name). The OUT option specifies that the 
conversion is to be used on all OUTPUT data on the specified path; I H specifies that the 
conversion is to be used on all ENTER data on that path. The conversion is not performed on 
SEND and TRANSFER operations. 

Separate IN and OUT conversions can be specified for the same I/O path. 

When the optional parameters are omitted, the previously specified conversion for that I/O 
path and direction is disabled. 
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CONVERT by PAIRS. PR I RS specifies that the conversion string contains pairs of characters. 
Each pair consists of the original character and the character to which it is converted. Before 
each character is moved through the interface or buffer, it is compared to the original charac- 
ters in the conversion string. If a match is found, it is replaced by the character following the 
original character. 

CONVERT by INDEX. INDEX defines a conversion table based on the string variable. The C 
decimal value of each incoming or outgoing character is interpreted as a character position 
value in the table. For example, an incoming # (decimal value 35) is converted to the 35th 
character in the string variable. 

Related Keywords 

ENTER, OUTPUT 
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COPY 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The COPY statement copies an individual file or all the files in a specified directory. 



(copy) - 



O 



file 
name 



C name T 

HP-UX I J 



O 



HP-UX 
path name 



string 
expression 



<™> 



o 



file 
name 



HP-UX 
path name 



string 
express ion 



o 



Item 


Description 


Range 


file name 

HP-UX path name 
string expression 


literal 

literal (see glossary) 

expression evaluating to an HP-UX path name 


14 characters 
maximum; slash, 
quotation marks, 
and leading colon 
not allowed; 



Examples 

COPY Vdiscfl/testl/trialS" TO VdiscB/testla/tr ial5" 
COPY "/mydisc" TO "/yourdisc" 

Description 

Two copying operations are available. File-to-file copy copies the contents of a non-directory 
file to a new file. The new file can be in the same directory or in another directory. Directory- 
to-directory copy copies the contents of all the files in a directory to another directory. The 
syntax of both operations is the same; the type of copying that occurs depends on whether the 
file to be copied is a directory file. 
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...COPY 



Files secured with type 1 security cannot be copied. No error is generated, but the copying 
operation does not occur. 

Attempting to copy a file to a disc with insufficient space for that file causes an error. If the 
error occurs during a directory-to-directory copy, all files copied before the error remain intact. 

File-to-File Copy. When the file to be copied is a non-directory file, file-to-file copying oc- C 
curs. File-to-file copying creates a new file with the specified name in the directory indicated 
by the path name of the new file. The contents of the source file is copied into the new file, 
and the directory in which the new file is located is updated. The source file and the new file 
can be in the same directory if they have unique file names. If a file name is used alone, that 
file must be located in, or will be created in, the current working directory. 

Directory-to-Directory Copy. When the file to be copied is a directory file, all the files in 
the source directory are copied to the destination directory, and the destination directory is 
updated to add the new files. The destination directory must have been previously created. 
The names of the copied files are not changed. Subdirectories are not copied. 

If a duplicate file name or other non-fatal copying error occurs during copying, that file is 
skipped and copying continues. An error message is displayed when copying is completed. If 
more than one non-fatal error occurs, only one message corresponding to the first error is 
displayed. 

If a file name alone is used, it must be the name of a directory file in current working 
directory. 

Related Keywords 

SECURE, UHSECURE 
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COS 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The COS function returns the cosine of the angle argument. 



e^ & 



numeric 
argument 



o-~ 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 

Y=COS(flng le) 
X=R#COS<Theta) 

Description 

The angle argument is interpreted according to the current trigonometric mode — RAD (radi- 
ans), DEG (degrees), or GRAD (grads). The default mode is RAD. 

Related Keywords 

ACS, DEG, GRfiD, RfiD 
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COT 



Keyboard Executable 
Programmable 

In an IF...THEN 



The COT function returns the cotangent of the angle numeric argument. 



G°D— <<> 



numeric 
argument 



<>> 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 



Y=COT<Theta> 

D I S P " C o t a ng e n t o f a ng 1 e is".: 



COT<H> 



Description 

The angle argument is interpreted according to the current trigonometric mode — RAD (radi- 
ans), DEG (degrees), or GRAD (grads). The default mode is RAD. 

Related Keywords 

FiTN, ATN2, DEG, GRRD, RflD, TflH 
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CREATE 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The CREATE statement creates a BASIC/DATA file on a disc. 



( CREATE ) -r— Q 



HP-UX 
path name 



J 



_ /^|P N ^ /^~^ a. number of 
*\J~l >v/v records 



string 
expression 



I w^~^\ |recondl J 

^ niength| 



Item 


Description 


Range 


file name 

HP-UX path name 
string expression 
number of records 

record length 


literal; name of a file in the current working directory 

literal; an absolute or relative path name (see glossary) 
expression evaluating to a file name or HP-UX path name 
numeric expression, rounded to an integer 

numeric expression, rounded to an integer (default =256) 


14 characters 
maximum; slash 
and leading colon 
not allowed 

limited by capacity 
of medium 

>4 bytes 



Examples 



CREATE "newfile".. 2@ , 64 

CREATE " ,--d i sc 1 .•••new file", Recs, Si: 
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...CREATE 



Description 

If the file name is used alone (rather than as part of an HP-UX path name), the file is created 
in the current working directory. When an HP-UX path name is used, the file is created in the 
specified directory. An error is returned if the file name already exists. 

When the file is created, space is allocated to it on the disc, and a directory entry is made. The 
file is not opened when it is created. 

Regardless of the file size, the first 256 bytes of a BASIC/DATA file is set aside to store file 
management information, and is unavailable for data storage. Minimum file size is one 
block — 1024 bytes. Files are created in integer number of blocks, and additional logical 
records of the specified record size are added, if necessary, to fill the file. For example, 
CREATE "file" , 5@, 30 creates a 2-block file containing 59, 30-byte records and 256 
bytes of ovehead. 

Related Keywords 

flSSIGNtt 
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CRT IS 



Keyboard Executable 
Programmable 

In an IF...THEN 



The C R T I S statement selects the destination device for output ordinarily displayed. 

( crt is y 



device 
se 



lector T 

file I J 



selector 



i w/^T^ J line 



ZT1 

line ) 



Item 


Description 


Range 


device selector 
file selector 
line length 


numeric expression, rounded to an integer (see glossary) 

numeric expresison, rounded to an integer 

numeric expression, rounded to an integer (default =80) 


1 1 through 20 
1 through 220 



Examples 

CRT IS I 
CRT IS PI 
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...CRT IS 



Description 

Error messages and output from DISP (USING), LIST, and CRT, are sent to the CRT IS 
device or to the specified file. 

The line length specifies the maximum number of characters sent to the CRT IS device before 
an end-of-line (EOL) sequence is sent. EOL character(s) are not counted as part of the line 
length. When a DISP USING format string specifies output that exceeds the CRT IS line 
length, the line is broken at the line length and the format is continued at the beginning of the 
next line. 

Related Keywords 

ASSIGN, DISP, IMAGE 
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CSC 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The CSC function returns the cosecant of the angle argument. 



(f^>--<0— H a n n u g m u e ^ c t ! —-<>>—»» 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 

C o seca n t = C S C < H n g 1 e > 
DISP CSC^Theta) 

Description 

The angle argument is interpreted according to the current trigonometric mode — RAD (radi- 
ans), DEG (degrees), or GRAD (grads). The default mode is RAD. 

Related Keywords 

DEC, GRFiD, RFiD 
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Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The C SIZE statement specifies the height, aspect ratio (width/height), and slant of label 
characters. 



(csize) — » 



space 
height 



^0H 



aspect 
ratio 



^*\_») »• slant 



Item 


Description 


Range 


space height 


numeric expression, interpreted in graphics units (default=3 
GUs) 


— 


aspect ratio 


numeric expression (default = .6 for pen plotters; machine de- 
pendent for the display) 


— 


character slant 


numeric expression, interpreted according to the current 
trigonometric mode (default = 0) 


— x/2 < charac- 
ter slant < tt/2 
(RAD mode) 

-90 < character 
slant < +90 
(DEG mode) 

-100 < character 
slant < +100 
(GRAD mode) 



Examples 



IZE 12 

IZE 12, , 8 

IZE Height, S h a p e , S 1 a n t 
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Description 

The space height parameter is the height, in graphics units, of the character space (see glos- 
sary). The aspect ratio is the ratio of the width of the character to its height. 

The slant parameter specifies, in the current trigonometric mode, the clockwise slant of the 
character from vertical. If the slant parameter is out of range, the character slant defaults to 0. 

The following diagram and table describes how pen plotters position characters in the charac- 
ter space.* 



space width 



character 
height 



r — ■\ 













































space 
height 



character 
width 



Character dimensions on the graphics display are machine-dependent. 
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CSIZE 



CSIZE Character Dimensions 



Character Dimension 


Description 


Space height 
Symbol height 
Space width 
Symbol width 


C SIZE space height parameter 
V2 x the space height 

3 A x aspect ratio parameter x height parameter 
2 /3 x space width 



Labels can be reflected by changing the sign of the CSIZE parameters: 
Reflecting Labels 



Sign of Height 


Sign of Aspect Ratio 


Effect 


positive 


positive 


unreflected 


positive 


negative 


reflected across y-axis 


negative 


negative 


reflected across x-axis 


negative 


positive 


reflected across origin 



Related Keywords 

DEG, GRFiD, RflD 
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CURSCOL 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The CURSCOL function returns the current column location of the cursor in alpha display 
memory. 



( CURSCOL ) — *■ 



Related Keywords 

CURS ROW 



2-86 Keyword Dictionary 



CURSOR 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The CURSOR statement reads the current location and status of the physical pen from the 
plotting device and assigns those values to numeric variables. 



C nirrnn ^ fc | x-coordinate | ^T~~\ fc |y-coordinat 
V . UUH&UH J n variable | *\' J \ variable 



I *f~?\ J P en status I J 
^\JJ variable 



Item 


Description 


Range 


x-coordinate 
variable 

y-coordinate 
variable 

pen status 
variable 


simple numeric variable or array element 
simple numeric variable or array element 
simple numeric variable or array element 


any valid name 
any valid name 
any valid name 



Examples 



C U R S R X p o sit i o n , V P o s i t i o n , P enstat u s 
CURSOR x < I '? , y < I > 

Description 

The pen x- and y- coordinates are interpreted according to the current units. The pen status 
variable is assigned the value if the pen is up, 1 if the pen is down. 

Related Keywords 

DIGITIZE, WHERE 
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CURSROW 



Keyboard Executable ■ 

Programmable ■ 

In an IF...THEH ■ 

The CURSROW function returns the current row location of the cursor in alpha display 
memory. 



( cursrow y 



Description 

The row number returned by C U R S R W corresponds to the cursor position on the screen when 
row 1 of display memory is at the top of the screen. 

Related Keywords 

CUR SCO l_ 
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DATA 



Keyboard Executable □ 
Programmable ■ 

In an IF...THEN D 

The DRTfl statement contains numeric and/or string data which is assigned to program vari- 
ables listed in one or more READ statements. (For information about using DRTfl as a 
secondary keyword, see SEND.) 



(data}- 



O 



numeric 
constant 



U^ ) literal p )— > 



Item 


Description 


Range 


numeric constant 
literal 


numeric quantity consisting of digits through 9 with op- 
tional decimal point, sign, and exponential notation 

string constant consisting of characters entered from the 
keyboard 


— 



Examples 

DATA 2,4,6. 
DATA ABC, 2 



!E2U,DEF 



1 e 3 d i n g ■-■ p a i_ e : 
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...DATA 



Description 

A program can contain any number of DATA statements. The statement is declaratory, and 
extra data is ignored if there are no corresponding READ variables. A data pointer is used to 
access data items. A (sub)program's READ operations start with the first item in the lowest 
numbered DATA statement. When all data items in a DATA statement have been read, the 
pointer moves to the next-higher numbered DATA statement. 

When a READ statement accesses a DATA statement for a numeric variable assignment, the 
data constant must be a numeric value. When the READ statement is assigning a value to a 
string variable, the DATA statement can contain a numeric value, an unquoted string, or a 
quoted string; a numeric value is interpreted as a literal containing digits. Quotation marks are 
regarded as string delimiters, and are not part of the string. Strings delimited by quotation 
marks, however, can contain commas and leading and trailing blanks. 

Quotation marks around literals are optional and are not part of the assignment; the quotation 
marks make it possible to include leading and trailing blanks in literals. 

If the keyword is not followed by a numeric constant or literal, the statement is interpreted as 
DATA "" (null string). 

Subprograms maintain their own data pointers. When a subprogram is being executed, READ 
statements access DATA statements within the subprogram, starting with the lowest numbered 
DATA statement in the subprogram. When program execution returns to the calling program, 
READ operations resume where they left off when the subprogram was called. 

DATA statements cannot be included in multistatement lines. Comments (using the comment 
delimiter !) cannot be added to DATA statements. 

Related Keywords 

INPUT, READ, RESTORE 



2-90 Keyword Dictionary 



DATE 



Keyboard Executable 
Programmable 

In an IF...THEH 



The DATE function returns the current value of the system clock date counter. 



(date) *■ 

Description D 

The date counter is in the form YYDDD where YY is the year and DDD is the day number in 
the range 1 through 366. 

Related Keywords 

DATE*, TIME 
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D 



DATE$ 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The DATE* function returns the current value of the system clock date counter in 
YY/MM/DD format. 



(date$) — »- 

Related Keywords 

DATE, TIME 
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DEF FN 



Keyboard Executable D 
Programmable ■ 

In an IF...THEN □ 

The DEF FN statement defines a single-line user-defined function and its formal parameters. 
For multiple-line functions, DEF FN defines the beginning of the function and the formal 
parameters used within the function. 



Ci-,,-,- ,-n " ^ ^I numeric f unct ion 
UU- l-N J ~* \ name 



Ki> 



o 



numeric 
parameter 



string 
parameter 



► formal parameters 



Wt>^|!S^r-<J>^ 



>, fc /^T\ fc numeric 
\J expression 



required for single- 
line functions 



required for single- 
line f unct ions 



DEF FN 



string function 
name 



U(T> 



o 



numeric 
parameter 



►formal parameters 



string 
parameter 



> Hj>H!S^Hj)-- 1 



^~(=H 



string ) 



epression 
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...DEF FN 



Item 


Description 


Range 


numeric function 
name 


name of the user-defined function 


any valid numeric 
variable name 


numeric 
parameter 


numeric variable name 


subscripted vari- 
ables not allowed 


string parameter 


string variable name 


subscripted vari- 
ables not allowed 


numeric 
expression 


(see glossary) 


— 


string function 
name 


name of the user-defined function 


any valid string 
variable name 


string expression 


(see glossary) 


— 


string length 


numeric expression, rounded to an integer 


1 through 65,530 



Examples 



DEF F N C u b e (. H u m b e r ':> = H u m b e r ■"" 3 
DISF FNCube(Side) 

DEF FHS 1 ash* < S t r i ng *C 38 1 > 

FOR 1=1 TO 30 

IF String*C I, I :=",-" THEN S t r i ng *C I , I 1= " .: " 

NEXT I 

FHS 1 ash$ = S t r i ng *C 1 , 1 8 1 
FN END 
PRINT# 1, FK1>; FHSlash*<B*> 
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...DEF FN 



Description 

A maximum of 30 parameters can be passed into the function. The formal parameters listed in 
the DEF F H statement must match the actual parameters listed in the calling F H statement in 
type — numeric versus string. The actual parameters are passed into the user-defined function 
by value; any changes made to parameters within the user-defined function are local to the 
function and not available to the rest of the program. However, all program variables (except 
those whose names are the same as formal function parameters) are available in the user- 
defined function. 

Function definitions are local to the program or subprogram in which they are located. 

If a string parameter passed into a function is longer than 18 characters, it must be dimen- 
sioned within the function DEF FN statement. When a string user-defined function passes a 
string expression back to the program, that expression can be no longer than 18 characters. 

User-defined functions must not be recursive. DEF FN cannot be included in a multistatement 
line. 

Single-Line Functions. DEF FN is a declaratory statement; it is ignored if the function is not 
referenced. Single-line functions must include the function assignment (= numeric expression 
or = string expression). 

ON ERROR branching should be disabled before execution of a single-line function. Other- 
wise, an error could cause premature exit from the function. 

Multiple-Line Functions. The DEF FN statement defines the beginning of the function; 
FN END defines the end. An FN...= statement within the function defines the value passed 
back to the program. Branching statements should not be used to exit the function. 

The block of statements defining the function can be placed anywhere within the program, 
except that a function cannot be nested within another function. 

Related Keywords 

FN 



D 
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D 



DEFAULT 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The DEFAULT statement specifies how warnings are handled by the system. 



( DEFAULT ) -r-** ( 0FF ) 



on)— > 



Examples 

DEFRULT OFF 

IF flngle=@ THEN DEFRULT ON 

Description 

With default on, warnings generate a message and, if relevant, a default value. With default 
off, warnings generate a message and halt execution. The power-on condition is default on. 



Update 1 2/85 
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DEG 



Keyboard Executable 
Programmable 

In an IF...THEH 



The DEG statement sets degrees as the unit in which angles are measured. 



(peg ) *■ 

Description 

When DEG is executed, all angle parameters in statements and functions are interpreted as 
degrees. (There are 360 degrees in a circle.) All functions returning an angle return a value in 
degrees. 

The angle mode of a program is global. When a subprogram is called, the current angle mode 
is carried into the subprogram. If a subprogram changes the angle mode and then returns to 
the main program, the new mode is carried back to the main program. 

Related Keywords 

GRflD, RflD 
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DELETE 



Keyboard Executable 
Programmable 

In an IF...THEH 



The DELETE command deletes program lines from the current program or subprogram in 
memory. 



( DELETE y 



beginning line 
number 



V, /^\ ending line ) 

\^\/ number 



Item 


Description 


Range 


beginning line 
number 

ending line 
number 


integer constant identifying a program line 
integer constant identifying a program line 


1 through 65,535 
1 through 65,535 



Examples 

DELETE 39 
DELETE 30,90 



Description 

Specifying only the beginning line number deletes that line. Specifying both parameters de- 
letes all lines within that range. 

When both a main program and one or more subprograms are present in memory, DELETE 
acts upon the program specified by the previous FIHDPROG statement. 

Related Keywords 

F I N D P R G, S C R fi T C H , S C RAT C H S U B 
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DET 



Keyboard Executable 
Programmable 

In an IF...THEH 



The DET function returns the determinant of the specified matrix. 



CeE>— G> 



matrix 
name 



o 



Item 


Description 


Range 


matrix name 


name of a two-dimensional numeric array 


any valid name 



D 



Examples 



D e n o m i n a t o r = D E T <■. M a t r i x 1 
IF DET<fl>=8 THEN 309 



Description 

The specified matrix must be a square matrix. (The number of rows must equal the number of 
columns.) 



Related Keywords 

DETL 
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D 



DETL 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The DETL function returns the determinant of the last matrix inverted in a M AT . . . I N '...' state- 
ment, or the determinant of the cofficient matrix (first argument in parentheses) in the most 
recently executed MAT... SYS statement. 



(dFl> 



Examples 

fl=DETL 

IF DETL=0 THEN 460 

Description 

The matrix whose determinant is returned must have been previously specified in a MAT... I N 1 
statement or a MAT... SYS. The most recently executed statement is used. 

Related Keywords 

DET, MAT...IHV, NAT...SYS 
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DIGITIZE 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The DIGITIZE statement inputs the physical pen position and status from the current plot- 
ting device and assigns those values to the specified variables. 



r r 



k. 



DIGITIZE 



[H 



x-cq ordinate 
variable 



y-co ordinate 
variable 



^ZH 



pen status 
var iable 



u 



Item 


Description 


Range 


x-coordinate 


simple numeric variable or array element 


any valid name 


variable 






y-coordinate 


simple numeric variable or array element 


any valid name 


variable 






pen status 


simple numeric variable or array element 


any valid name 


variable 







I 



Examples 



DIGITIZE X posi t i o n , V P o s i t i o n , P e n s t a t u : 
DIGITIZE xU), yd) 
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D 



...DIGITIZE 



Description 

The pen x- and y-coordinates are interpreted according to the current units. The pen status 
variable is assigned the value if the pen is up, 1 if the pen is down. 

When DIGITIZE is executed, program execution is suspended until the pen coordinates (and 
optional status) are entered from the plotting device. 

Digitizing is aborted by pausing the program. 

Related Keywords 

CURSOR, WHERE 
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DIM 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH □ 

The D I M statement allocates memory for REAL numeric arrays, string variables, and string 
arrays. 



dim)- 



numeric 
array name 



string variable 
name 



o 




o-, 



upper 
bound 



■0- 



K<> 



O^ 



upper 
bound 



■d> 



<2H 



string 
length 




Item 


Description 


Range 


numeric array 


name of a numeric array 


any valid name 


name 






upper bound 


integer constant 


1 through 65,530 


string variable 


name of a simple or array string variable 


any valid name 


name 






string length 


integer constant 


1 through 65,530 



Examples 



D I M H < 3 9 9 > , B < 2 , 5 > , C $ L 2 1 
DIN D*'::25>C303, E* < 3 ., 3 > I 3 1 
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■■■DIM 

Description 

One- and two-dimensional arrays are allowed. 

If an array is to be explicitly dimensioned, the dimensioning statement must be executed be- 
fore any of the elements of the array are referenced. If an element is referenced before the 
array is explicitly dimensioned, an array is implicitly dimensioned with upper bound(s) equal 
to 10. If a string variable is referenced before the string length is dimensioned, the string 
length is implicitly dimensioned to 18. 

A variable can be dimensioned only once within a program; an attempt to dimension a vari- 
D able that has already been explicitly or implicitly dimensioned causes an error. 

A program can contain any number of D I M statements. If the program contains an 

OPT I OH BASE statement, dimensioning statements must occur after the option base has been 

declared. 

The dimension(s) of a variable are global, known to the program and any subprograms to 
which the variable is passed. 

Related Keywords 

INTEGER, REAL, SHORT 
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DIRECTORY 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The DIRE C T R Y statement displays a directory of the main program and the subprograms 
currently in system memory. 



(" DIRECTORY ) »- 

Description 

The directory lists the subprograms in their order in system memory, along with the 
deallocated size, the number of lines, and the allocation status of each subprogram. An arrow 
(> ) indicates the current (sub)program. The subprogram names listed in the directory are the 
names with which the subporgrams were initially created (using FINDPROG) and stored. 

Related Keywords 

FINDPROG, SCRHTCHSUB 
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DISP 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The DISP statement outputs the display items to the current display line. 



(oisp) - 



^-»{USING 



0- 



IMAGE line 
number 



IMAGE line 
label 



0- 




o 



display 
items 



T I numeric 

expression 



string 
expression 



^-» ( TAB ) — **(T)— » colu 



W^ 



Trailing punctuation 
ignored with USING. 



TAB not allowed 
with USING. 
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...DISP 



Item 


Description 


Range 


IMAGE line 


integer constant identifying an IMAGE statement 


1 through 65,535 


number 






IMAGE line label 


name identifying an IMAGE statement 


any valid line 
name 


format string 


string expression containing one or more field specifiers (see 
I M A G E statement for syntax) 


— 


column 


numeric expression, rounded to an integer 


-99,999 through 
99,999; negative 
numbers are inter- 
preted as 1 


numeric 


— 


— 


expression 






string expression 


— 


— 



Examples 

DISP Number; Letter* 

D I SP TAB ■:: 1 > : A* , " Resu 1 t s.= " .: Result 

D I SP US I NG " DC3D , 5D , 4X , 7 A " : A , " do liars" 

DISP USING 100: A,B$,C 

Description 

The keyword U S I N G provides for specifying the format of output. When D I S P is executed 
without USING, a standard format is used. 

Simple DISP (Without USING). Simple DISP uses standard number format (see glossary) 
for numeric items, and displays numeric and string items in either of two field widths: 

■ When display items are separated by semicolons, they are displayed in narrow format with 
a leading blank or minus sign. Strings are output with no leading or trailing blanks. 

■ When display items are separated by commas, they are displayed in wide format, left-justi- 
fied in 21 -column fields. Items longer than 21 characters occupy more than one field. 
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D 



...DISP 



When the TAB function is included as a display item, the cursor moves to the designated 
column. Negative column numbers are treated as TAB(l). Column numbers greater than the 
line length are reduced MOD (line length). When TAB is used to control format, display items 
should be separated by semicolons; using commas causes output to be displayed in wide 
format. 

When the list of display items is exhausted, an end-of-Line (EOL) sequence, ordinarily car- 
riage return/line feed, is sent to the display. The EOL can be suppressed by including a 
comma or semicolon after the last display item. 

Control Characters. Control characters can be included as display items by specifying their 
ASCII code as argument in the CHR* function or by using the metacharacter ~ followed by 
the character decimal code. 

Formatted Output. D I S P U S I N G uses a format string contained in the statement itself or in 
a referenced I M R G E statement to format the output. The format string, consisting of one or 
more field specifiers separated by delimiters (comma or slash), is used from left to right. Dis- 
play items are paired with their corresponding field specifiers. Certain field specifiers do not 
use a display item (for example, X). 

If the format string is exhausted before all the display items have been processed, the format 
string is reused from the beginning. Extra field specifiers are ignored. If a field is larger than 
the numeric item, the number is right-justified in the field. A warning is issued if the number 
is larger than the field. (A minus sign requires a digit position if M or S is not included in the 
field specifier.) Numbers are rounded to the number of decimal placed indicated by the field 
specifier. Standard number format can be chosen by using the image specifier K. 

The T R B function cannot be used with D I S P U S I H G . 

When the list of display items is exhausted, an end-of-line (EOL) sequence, ordinarily carriage 
return/line feed, is sent to the display. The EOL can be suppressed by placing the image 
specifier # at the beginning the format string. Unlike with simple DISP, a terminating semi- 
colon or comma is ignored and does not suppress the EOL sequence. 

Refer to I M fl G E for the syntax of the format string. 

Related Keywords 

IMAGE, OUTPUT, PRINT 
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DIV 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The D I V operator returns the integer portion of the quotient resulting from a division opera- 
tion. The DIV operation can also be indicated by the symbol \. 



dividend 



» ( DIv) -j-»» d 




Item 


Description 


Range 


dividend 
divisor 


numeric expression 
numeric expression 


^0 



Examples 

C=fl DIV B 
DISP <fl+B>\C 



Description 

A DIV B is equivalent to the expression IP(A/B). 

Related Keywords 

MOD 
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DOT 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The DOT function returns the dot product of two vectors. 



G^y~ <T> H V na^rh -<0-- H V nar| --<y>--^ 



Item 


Description 


Range 


vector name 


name of a one-dimensional numeric array 


any valid name 



Examples 

DISP D0T<fl,B> 

IF DOT<C,D>=0 THEN 609 

Description 

The dot product (scalar product) of two vectors is computed by summing the products of the 
corresponding elements of the two vectors. The two vectors must be the same size. 

Related Keywords 

MAT 
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DRAW 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEM ■ 

The DRAW statement lowers the pen and moves it to the specified x-, y-coordinate position. 
The pen remains down until it is raised by another statement. 



(jdraw)- 



x-coordinate 



<H 



y-coordinate 



Item 


Description 


Range 


x-coordinate 
y-coordinate 


numeric expression, interpreted in the current units 
numeric expression, interpreted in the current units 


— 



Examples 

DRAW 10, IS 

D R fl W X P o s i t i o n , X P o s i t i o n * 5 

Description 

DRAW uses the current units mode (UU's or GU's) and line type. In UU's mode, lines cannot 
be drawn outside the plotting boundaries. In GU's mode, the plotting boundaries become 
equivalent to the graphics limits; therefore, lines can be drawn anywhere within the graphics 
limits. 

In both UU's mode and GU's mode, the logical pen can be moved outside the plotting area. 
However, the physical pen cannot be moved beyond the plotting boundaries. 



Related Keywords 

I DRAW, LINE TYPE, MOVE, PLOT 
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DTB$ 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The DTB$ (decimal-to-binary) function returns a string containing the base 2 representation of 
the decimal argument. 



(dtb$ ) «-(7) >■ 



numeric 
argument 



o 



Item 


Description 


Range 


numeric argument 


numeric expression, truncated to an integer 


— 



Examples 

fl*=DTB*<45> 

DISP DTB*<X<1)^X<2)> 

Related Keywords 

BTD, DTH*, DTO*, HTD, OTD 
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DTH$ 



Keyboard Executable I 
Programmable I 

In an IF...THEH I 

The DTHt (decimal-to-hexadecimal) function returns a string containing the base 16 representa- 
tion of the decimal argument. 



(W)— <Q— H a^u^t [ — *Q>- » 



Item 


Description 


Range 


numeric argument 


numeric expression, truncated to an integer 


— 



Examples 



DISP DTH*'::5709> 

IF DTH*a<5)> = "fl4" THEN 






Related Keywords 

BTD, DTB*, DTO*, HTD, OTD 
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DTO$ 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The DTO* (decimal-to-octal) function returns a string containing the base 8 representation of 
the decimal argument. 



(™s>- <r>— *{^ ^D—*- 



Item 


Description 


Range 


numeric argument 


numeric expression, truncated to an integer 


— 



Examples 

Y*=DT0*<flCl>> 
DISP DT0*<512+X> 



Related Keywords 

BTD, DTB$, DTH$, HTD, OTD 
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DTR 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The DTR (degrees-to-radians) function interprets the numeric argument as an angle measured 
in degrees, and returns the value of the angle in radians. 



^>— <Q- H a^e n't h ~ *Q) 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 

R a d i a n s = D T R '■. D eg rees > 
DISP DTROe) 

Description 

The argument and value returned by DTR are independent of the current trigonometric mode. 

Related Keywords 

RTD 



Keyword Dictionary 2-115 



D 



DUMP ALPHA 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The DUMP ALPHA statement copies the contents of the alpha display to the PRINTER IS 
device. 



( DUMP ALPHA ) *» 

Related Keywords 

DUMP GRAPHICS 
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DUMP GRAPHICS 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The D U M P G R fl P H I C S statement copies the contents of the graphics display to the internal 
printer. 



DUMP GRAPHICS 



)— 



Description 

The internal printer (located at interface select code 2) must be the current PRINTER IS device. 
The display must be the current PLOTTER IS device. 

The contents of the graphics display is copied dot-by-dot. 

Related Keywords 
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ENABLE INTR 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The ENABLE I N T R statement enables the specified interface for generating an interrupt 
which can cause end-of-line branching. 



<j 



ENABLE INTR 



> 



interface 
select code 



o 



enable 
byte 



Item 


Description 


Range 


interface select 
code 

enable byte 


numeric expression, rounded to an integer 

numeric expression, truncated to an integer and moduloed 
256 


3 through 10 



Examples 

ENABLE INTR 7: 
ENABLE INTR Is. 



BTCK "101" > 



Description 

The binary representation of the enable byte is written into Control Register 1 of the specified 
interface. The significance of each bit is interface-dependent. 

The end-of-line branch taken when an interrupt is generated is specified by an N I N T R 
statement. 

Executing ENABLE INTR is equivalent to executing a CONTROL statement to Control 
Register 1. 

Related Keywords 

CONTROL, ON INTR, STATUS 
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ENABLE KBD 



Keyboard Executable 
Programmable 

In an IF.. .THEN 



The ENABLE K E D statement enables and disables various keyboard keys during program exe- 
cution and/or keyboard input (INPUT and L INPUT). 



( ENABLE KB[P)- 



Item 


Description 


Range 


mask 


numeric expression, rounded to an integer 


through 255 



Examples 



ENABLE KBD 16 
ENABLE KBD KeyMask 



Description 

The binary equivalent of the decimal mask is used to activate (enable) and deactivate (disable) 
various portions of the keyboard. The keyboard is divided into four areas: 



The (reset) * key. 

The (pause) * key. 

The special function keys. 

All other keys. 



* Machine-dependent key or control sequence. 
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...ENABLE KBD 



Keys can be activated and deactivated separately for program execution (while the program is 
running) and keyboard input (while the program is halted at an INPUT or LINPUT state- 
ment). Setting a bit (1) activates the key(s); clearing a bit (0) deactivates the key(s). 



Bit Number 


Decimal Value 


Operating Mode 


Key(s) Affected 


7 
6 


128 
64 


program execution 
program execution 




(RESET)* 


(PAUSE)* 


5 


32 


program execution 


special function 
keys 


4 
3 
2 


16 
8 
4 


program execution 
keyboard input 
keyboard input 


all other keys 


(RESET)* 


(PAUSE)* 


1 


2 


keyboard input 


special function 
keys and-all-other 
keys— 





1 


keyboard input 


special-fwtetteB- 
keys-anchall other 
keys 


* Machine-depends 


snt key or control seque 


nee. 








Related Keywords 

INPUT, LINPUT, ON KEY*, ON KYBD 
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END 



Keyboard Executable □ 
Programmable ■ 

In an IF. ..THEN ■ 

The END or STOP statement is the last statement executed by a program. 



( end) 

C 



STOP 



Description 

END and STOP are interchangeable. The statements are optional and can appear anywhere in 
the program. More than one END and/or STOP statements are allowed. 

Related Keywords 

STOP 
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ENTER 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The E N T E R statement inputs bytes of data from a device or buffer and assigns the data to the 
specified numeric and/or string variables. 



(enter)- 



1/0 buffer 
name 



device 
selector 



J ^-"{using)- 



IMAGE line 
number 



IMAGE line 
label 



.. ^/ ITN Iformat 



<D- 



cSn 



numeric 



o 



o 



( — VJ~ — • 

^-*(( J ' » subscript ' — H 



-<>> 



string 



^-»\( J * > ■ subscript — ' — *•{ 



V fc/T^ Jbeginninc 
"" \^_y position 

~*\L) L^/TYJ ending 

^V^,/ position 



o-> 
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Item 


Description 


Range 


device selector 


numeric exprssion, rounded to an integer (see glossary) 


— 


I/O buffer name 


name of a string variable declared as an I/O buffer 


— 


IMAGE line label 


name identifying an IMAGE statement 


any valid line label 


IMAGE line 
number 


integer constant identifying an IMAGE statement 


1 through 65,535 


format string 


string expression consisting of one or more field specifiers 
(see page 2-126 for syntax) 


— 


numeric name 


name of a numeric variable 


any valid name 


string name 


name of a string variable 


any valid name 


subscript 


numeric expression, rounded to an integer 


1 through 65,530 


beginning position 


numeric expression, rounded to an integer 


1 through 65,530 


ending position 


numeric expression, rounded to an integer 


1 through 65,530 



Examples 



ENTER 761 USING Enter for mat: hi, B$, C 



ENTER 



<ar 1 , 



ar 2 
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...ENTER 



Table of Image Specifiers and Delimiters For ENTER 



Image Specifier 



Meaning 



D, Z, *, 



S, M 



Directs the computer to skip one character. 

All six specifiers accept one character to be used in building a numeric variable. 
The characters may be the digits through 9, the decimal point, and signs. The 
six different specifiers are provided for documentation purposes and for compati- 
bility between OUTPUT and ENTER format strings. 

The number or string is input in free field format (see glossary). 

Inputs one string character. 

Inputs one byte of binary data and enters its decimal equivalent into a numeric 
variable. 

Inputs two bytes of binary data to be used in building a 16-bit, 2's complement 
binary word. The first byte entered is the most significant. The decimal equivalent 
of the resulting word is entered into a numeric variable. 

Accepts one character for building a numeric variable, and provides for ignoring all 
commas while the number is being entered. (Without this specifier, a comma ends 
the entry of the number.) 

Inputs an exponent consisting of the letter E, a sign, and three digits. 

Inputs an exponent consisting of the letter E, a sign, and two digits. 

Causes computer to skip to the beginning of a new field. The new field is indi- 
cated by a line feed. 

When used as a statement terminator specifier, eliminates the requirement for a 
line feed to terminate the ENTER statement; the ENTER statement terminates 
as soon as the last variable in the statement has been satisfied. When used as a 
field terminator specifier, eliminates the line feed as a terminating condition during 
free-field entry; line feeds entered are placed in the string. 

When used as a statement terminator specifier, allows EOI or line feed as termi- 
nating condition. When used as a field terminator specifier, allows EOI as an 
additional terminating condition. 



Related Keywords 

C N '■..' E R T, I M H G E, I B U F F E R 
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...ENTER 



format string 




■CH 



O 



field 
specif ier 



J J field I [_, 

1 ~ spec if ier ~ 



L Irepeatl fc fT^ t J field |_J_ fc /T\_J 

~factpr| ^J^' ~specif ier | \»V 



■©— 



field specifier 



<*> 



-ay 



Mn^ 






"C^J 



C®-L 



MseoP 



c&i 



U0_J 



0- 



^H^ 



C®_L 



t-EUP 



£^ 



Muh' 



^ 



L <5> J 



^mP 



U@-J 



U0-J 



-o- r^^^h o- 
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EPS 

The EPS function returns machine epsilon, the smallest positive REAL number. 



(eps> 



Examples 

DISP EPS 

Related Keywords 

INF 
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E 



ERRL 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The ERRL function returns the line number of the program line generating the most recent 
error or warning. 



(errl) - 



Examples 

PRINT ERRL 

IF ERRL=2@0 THEN GOSUB 70S 



Related Keywords 

ERRM, ERRN, ERROM, ERRSC, OH ERROR 
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ERRM 



Keyboard Executable 

Programmable 

In an IF...THEH 

The ERRM statement displays the error message generated by the most recent error. 



(errm) *- 

Description 

If no error has occurred since power on, reset, SCRATCH, LOAD, or GET, the system displays 

Error : 0. 

ERRM is useful as part of an OH ERROR recovery routine, where no error message would 
otherwise be displayed. 

Related Keywords 

ERRL, ERRH, ERROM, ERRSC, ON ERROR 
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ERRN 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The ERRN function returns the error number of the most recent error or warning. 



(errn) +■ 

Examples 

DISP ERRN 

IF ERRN=49 THEN GOSUB Assignment 



e Description 

If no error has occurred, ERRN returns 0. 

Related Keywords 

ERRL, ERRM, ERROM, ERRSC, ON ERROR 
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ERROM 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The ERROM function returns a number indicating which BASIC module returned the most 
recent error or warning. 



(errom) — »- 

Examples 

DISP ERROM 

IF ERRN=113 HMD ERR0M=232 THEN 488 

Description 

ERROM is used to distinguish between two or more errors having the same error number but 
originating from different BASIC modules. 

Related Keywords 

ERRL, ERRM, ERRN, ERRSC, ON ERROR 
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E 



ERRSC 



Keyboard Executable 

Programmable 

In an IF...THEN 



The E R R S C function returns the interface select code of the interface that generated the most 
recent interface-dependent error. 



(errsc) — »- 



Examples 

IF ERRSC-7 THEN STATUS 7 , 1 .: C 
DISP ERRSC 

Description 

When an interface error occurs, E R R S C returns the interface select code of that interface until 
another I/O error occurs at another interface. If no interface error has occurred, ERRSC re- 
turns 0. 

Related Keywords 

ERRL, ERRM, ERRN, ERROM, ON ERROR 
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EXOR 



Keyboard Executable 
Programmable 

In an IF...THEH 

The EXOR operator returns a 1 or based on the logical exclusive-OR of the operands. 



operand 



-»(exor)- 



operand 



Item 


Description 


Range 


operand 


numeric expression 


— 



Examples 



T = flU> EXOR fl<2> 

I F Y o u E X R C i z e THE H Y o uHealt h y 



Description 

A non-zero operand (positive or negative) is interpreted as a logical 1. An operand of zero is 
interpreted as a logical 0. The following table describes the results of performing an EXOR 
operation. 



Exclusive OR 


A 


B 


A EXOR B 














1 


1 


1 





1 


1 


1 






Related Keywords 



AND, HOT, OR 
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EXP 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The E X P numeric function returns the natural (base e) antilogarithm by raising e to the power 
of the argument. 



G^y-*Gy^ \ srZ e : e £ \ -+G) 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 

K = fl*EXP<-E..-RT> 
PRINT fl :EXP'::fi;' 



Related Keywords 

LOG 
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FINDPROG 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN □ 

The F I H D P R: G statement locates (and retrieves, if necessary) the specified subprogram in 
system memory or mass storage. When FINDPROG is executed from the keyboard, a system 
pointer is positioned at the subprogram so that it can be listed and edited. 



(findprog)- 



-Ovi 



subprogram 
name 



HP-UX 
path name 



string 
expression 



o- 



Item 


Description 


Range 


subprogram name 


literal 


14 characters 
maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name 


— 



Examples 



FINDPROG 

FINDPROG "SubSor t " 

FINDPROG FileHame$& 
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Description 

When FINDPROG is executed without a parameter, the pointer is moved to the main program. 

FINDPROG first searches computer memory for the specified subprogram. If the subprogram 
is not found, the current working directory or specified mass storage location is searched. The 
HP-UX path name must be used if the subprogram is not located in computer memory or in 
the current working directory. If the subprogram is found in mass storage, it is brought into 
system memory. 

If the specified subprogram is not found in system memory or in mass storage, the pointer is 
moved to a new block of system memory. The system displays NEW PROGRAM, indicating 
that a new subprogram can now be entered from the keyboard without overwriting other 
programs currently in memory. The FINDPROG name must be used when the new subpro- 
gram is stored. 

Related Keywords 

CALL, DIRECTORY, STORE 
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FLAG 



Keyboard Executable 
Programmable 

In an IF...THEN 



The FLhG function returns the status of the specified flag — set (1) or clear (0). 



Item 


Description 


Range 


flag number 


numeric expression, rounded to an integer 


+ 1 through +64 



Examples 



IF FLflG(i) THEN 290 

IF FLRG'::fl>=FLnG«::B> THEN GOSUB 1690 



Related Keywords 

CFLflG, FLAGS, SFLflG 
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F 



FLAGS 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The FLAG* function returns an eight-character string whose binary representation shows the 
status of the 64 flags. 



(flags) — ►- 

Examples 

DISP FLAG* 

IF FLflG*="H2a?"&CHR*< 1 2 > & " If M" THEN GOTO 400 

Description 

The left-most (most significant) bit of the left-most character represents the status of flag 1. 

When the FLAG* string is displayed, executable control characters are interpreted. Non-exe- 
cutable control characters are ignored. 

Related Keywords 

CFLfiG, FLAG 
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FLIP 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The FLIP statement causes the keyboard to toggle between typewriter mode operation and 
BASIC mode operation.* 



(flip) — ». 



Description 

In typewriter mode, the keyboard produces unshifted lowercase letters and shifted uppercase 
letters. In BASIC mode, the keyboard produces unshifted uppercase and shifted lowercase 
letters. Only letter keys are affected. The default condition is typewriter mode. 

When ON KYBD branching has been enabled for letter keys, the branch is taken only when 
the typed character in the current keyboard mode matches a character in the N K Y B D string 
expression. 

Related Keywords 

ON KYBD 



Implementation of FLIP is machine-dependent. 
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FLOOR 



See INT 



(floor) — *{T)- 



numeric 
argument 



o— 
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FN 



Keyboard Executable □ 
Programmable ■ 

In an IF...THEN ■ 

The FN keyword is a prefix used before the name of a user-defined function to identify a call 
to the function. Optional parameters in parentheses are passed to the function. The function 
returns a value used by the expression containing the function call. 

FH...= is used within a multiple-line, user-defined function to assign a value to the function. 
FN END defines the end of multiple-line functions. 



C PM ^ functior 
'" > name 



P 
h® 



numeric 
name 



^-*{( J — *■ subscript — *\)j 



strinc 
name 



^-*\ ( J — * subscript — *>f ) J ' 



L */T\ ,Jbeginninc 
\^/ \ position 



x~Qy- 



\_^T~\_A ending \J 
^\J_J \ position I 



-o- 



H numeric 
constant 



■T"j — * literal —*\") 



-<E> 



numeric 



' I expression I 

. . I Assignment for multiple- 

V- ^ string ) line function; expression must 



expression 



match function name in type. 



( FN END y 
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Item 


Description 


Range 


numeric name 


name of a simple numeric variable or numeric array 


any valid name 


subscript 


numeric expression, rounded to an integer 


1 through 65,530 


beginning position 


numeric expression, rounded to an integer 


1 through 65,530 


ending position 


numeric expression, rounded to an integer 


1 through 65,530 


literal 


string constant 


— 


numeric constant 


a numeric expression that can contain digits through 9, 
plus or minus sign, a decimal point, and exponential notation 


— 


string name 


name of a simple string variable or string array 


any valid name 


numeric or string 


(see glossary) 


— 


expression 







Examples 



Y = F N I n ■■..■ erse / H 

FHMu 1 t i 1 i neFunc t i on* = fl* 



"***" 



Description 

When FN invokes a user-defined function, the function type (numeric versus string) must 
match the context of the expression invoking the function. For example, the value returned by 
a string function cannot be assigned to a numeric variable. 

The parameters passed into a user-defined function by F H must match the D E F F N parameter 
list in number and type (numeric versus string). The parameters are passed by value; any 
changes made to the value of program variables within a user-defined function are not carried 
back to the program. Numeric and string variables, elements of numeric and string arrays, and 
substrings can be passed to a function. 
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...FN 



The FH...= statement must appear somewhere within a multiple-line function to assign the 
function a value which is returned to the program. 

Recursive user-defined functions are not allowed; a function cannot invoke itself. 

Related Keywords 

DEF FN 
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FNORM 



Keyboard Executable 
Programmable 

In an IF...THEN 



The FNORM function returns a value computed by squaring each element of the specified ar- 
ray, summing the squares, and then taking the square root of the sum. 



(fnorm ) — *{D" 



array 
name 



<D-~ 



Item 


Description 


Range 


array name 


name of a one- or two-dimensional numeric array 


any valid name 



Examples 



M=FHORM<flrray: 



Related Keywords 

CNORM, RHORM 
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FOR...NEXT 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN □ 



The FOR and NEXT statements together define a program loop that is repeated until a loop 
counter passes a specified value. 



(rnn "\ iJ l00D 1 *J^\ *\ initial I ^jT Tn "N ^1 final 
J\ counter \ ^\~J \ value \ ^ \ lu y * 1 value 



W^i^H flffH 



(next) - 



loop 
counter 



Item 


Description 


Range 


loop counter 


simple numeric variable name 


cannot be an 
array variable 


initial value 


numeric expression 


— 


final value 


numeric expression 


— 


step size 


numeric expression (default = 1) 


— 



Examples 



i F R C o u nter = l T 1 9 
110 D I S P C o u n t e r 

120 NEXT Counter 

290 FOR I=H TO N+M STEP stepsize 
220 FKI> = , 592*RBS>:: I-'-3::> 

230 IF f\<.l>>K THEN 400 

240 PRINT I., FKI> 

250 NEXT I 
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FOR NEXT 



FOR Statement 

loop counter - initial value 

Store final value and step size 




NEXT Statement 

loop counter - loop counter + 
step size 



Statement following 
NEXT 
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...FOR...NEXT 



Description 

The F R statement defines the beginning of the loop, sets the loop counter equal to the speci- 
fied value, and stores the final value and step size. Each time the HE'Al statement is executed, 
the loop counter is incremented (or decremented, in the case of a negative step value) by the 
step value and then compared to the final value. If the final value has not been passed, pro- 
gram execution is transferred to the statement immediately following the FOR statement. If the 
final value has been passed, program execution continues with the line immediately following 
the H E >< T statement. (The loop counter is not equal to the final value when the loop has been 
exited.) 

Because the loop counter is tested immediately after the FOR statement is executed (see flow- 
chart), the loop is not executed at all if the loop counter initial value is already past the final 
value. For example, a loop beginning with the statement FOR 1=3 TO 5 STEP - , 3 will 
not be executed, since 3 is already past (less than) the final value 5. 

The loop can be exited by unconditional or conditional branching; the loop counter retains is 
current value. The loop may be re-entered in the body of the loop or at the FOR statement. 
Entering a loop at the FOR statement reinitializes the loop counter. 

The FOR statement stores the loop counter, final value, and step size, and these values remain 
unchanged for the loop until the FOR statement is executed again. When the loop counter, 
final value, and step size are numeric expressions containing variables, the values of those 
variables can be changed within the loop without affecting how many times the loop is exe- 
cuted. However, changing the value of the loop counter within the loop can affect how many 
times the loop is executed. The loop counter can be used in expressions defining the initial 
value, final value, and step size. 

Each FOR statement must have one, and only one, matching NE,' :: ,'T statement. When 
FOR...HEKT loops are nested, one loop must be contained entirely within another. 
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FP 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The FP function returns the fractional part of the numeric argument. The function returns a 
value greater than — 1 and less than +1. A negative argument returns a negative value. 



CFP>- Hj)— H ^gZVn't h - »(7)— ■» 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 



Y=FP<X+Q? 
p IF FP<X>=8 THEN DISP " X IS HH INTEGER 

Related Keywords 

ip 
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FRAME 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The F R fl M E statement draws a frame around the plotting area using the current line type and 
pen number. 



(frame) — »- 

Description 

After the frame is drawn, the pen is positioned at the lower left corner of the frame and the 
pen is up. 

Related Keywords 

CLIP, LINE TYPE, LOCATE 
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FXD 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The FXD statement specifies the number of digits to the right of the decimal point in labels 
plotted by LAKES and LGRID. 



f FXD J * x-digits 



k>n 



y-dic 



its ' 



Item 


Description 


Range 


x-digits 
y-digits 


numeric expression, rounded to an integer 
numeric expression, rounded to an integer 


parameters out- 
side the range 
through 7 are in- 
terpreted as 
FXD(O) 

parameters out- 
side the range 
through 7 are in- 
terpreted as 
FXD(O) 



Examples 

FKD 3 
FKD 3,5 
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...FXD 



Description 

FXD allows for formatting LAKES and LGRID labels with through 7 digit positions to the 
right of the decimal point. A maximum of eight digits plus sign are allowed in the label. The 
x-digits parameter specifies the format for x-axis labels; y-digits specifies the format for y-axis 
labels. If the y-digits parameter is omitted, the x-axis and y-axis labels are formatted using the 
x-digits parameter. 

If a label is too large or too small for the specified label format, it is plotted in exponential 
notation. 

Related Keywords 

LfiXES, LGRID 
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GCLEAR 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

When the display is the current plotting device, the G CLEAR statement clears the graphics 
display to the current background color. 



( GCLEAR y 



^-* y-coordinate ' 



Item 


Description 


Range 


y-coordinate 


numeric expression 


— 



Examples 

IF X=8 THEN GCLEAR 
GCLEAR Y#2 

Description 

If a y-coordinate position is specified, the screen in cleared from that position to the bottom of ® 
the display. The y-coordinate is interpreted in the current scaling units. The current back- 
ground color is determined by the current pen number. 
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GCLEAR Background Color 



Pen Number 



>1 

-1 or «s-2 





Background Color After GCLEAR 



black 
white 
uses previous pen number 



If the current plotting device is a peripheral plotter, GCLEAR sends a page eject command. 

Related Keywords 



PEN 



G 
H 
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GET 



Keyboard Executable ■ 
Programmable □ 

In an IF...THEH □ 

The G E T command retrieves the specified text file from mass storage and attempts to enter the 
contents into memory as program lines. 



Ge>t-0 



file 
name 



HP-UX | j 

path name 



string 
expression 



o 



Item 


Description 


Range 


file name 


literal; name of a file in the current working directory 


14 characters 
maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name 


— 



Examples 

GET "aPet" 
GET fl$ 



G 
H 
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...GET 



Description 

GET retrieves ASCII character strings from the specified UNIX ASCII text file. The file must 
not contain control characters. Each record is read as a separate character string. When a string 
consists of a valid BASIC program statement preceded by a line number, the string is entered 
into system memory as a program line. If a string cannot be properly interpreted as a program 
line due to a syntax error, it is entered into system memory as a comment line. When GET 
encounters a character string that is not preceded by a valid line number, it displays the line. 

The retrieved lines are read into system memory without scratching the program already there. 
If an incoming line has the same line number as a line already in memory, the new line 
overwrites the original line. 

When the GET operation is finished, the system displays , . .end o f get. 

Related Keywords 

LOAD 



2-156 Keyword Dictionary 



GLOAD 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The GLOAD statement retrieves the specified BASIC/GRAF file and enters its contents into 
graphics display memory. 



(gload) -!-*^) 



file 
name 



HP-UX 
path name 



string 
expression 



Or* 



Item 


Description 


Range 


file name 


literal; name of a file in the current working directory 


14 characters 
maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name 


— 



Examples 



G 
H 



GLOAD "Fi lenarne " 

G L fi D " .-■ v 1 .-■ file n a m e " 

GLOAD ".--Dir 1 / D i r 2 / f i lenarne 
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Description 

If the file name is used alone (rather than as part of an HP-UX path name), GLOFiD uses the 
current working directory. 

Executing GLOflD clears the previous contents of the graphics display as the contents of the 
BASIC/GRAF file are entered into graphics display memory. The alpha display can be viewed 
again programmatically by executing ALPHA, or from the keyboard by pressing any key. 

Related Keywords 

MASS STORAGE IS, GSTORE 



G 
H 
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GOSUB 



Keyboard Executable □ 
Programmable ■ 

In an IF. ..THEN ■ 

The GOSUB statement causes program execution to branch unconditionally to the subroutine 
located at the specified line. 



(gosub) - 



1 ine 
number 



umber T 
1 ine ) 



Item 


Description 


Range 


line number 
line label 


integer constant identifying a program line 
name of a program line 


1 through 65,535 
any valid name 



Examples 

G S U B 76 

G S I J B m a r i n e 



Description 

The specified line must be in the same program or subprogram as the G S U B statement. If the 
specified statement is declaratory (for example, DIM, REM, or DflTH), the program branches to 
the next executable statement. 

When GOSUB is executed, execution of the subroutine continues until a RETURN statement 
causes branching to the statement following the GOSUB statement. 

Subroutines can be recursive; i.e., a subroutine can invoke itself. 

Related Keywords 

GOTO, OH. ..GOSUB, OH. ..GOTO, RETURN 



G 
H 
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GOTO 



Keyboard Executable 
Programmable 

In an IF...THEH 



□ 



The GOTO statement causes program execution to branch unconditionally to the specified line. 



(W>- 



1 ine 
numberl T 



line 
label 



Item 


Description 


Range 


line number 
line label 


integer constant identifying a program line 
name of a program line 


1 through 65,535 
any valid name 



Examples 

2 8 9 G TO 34 9 

3 @ G T I n c r e m e n t 

400 IF Happy THEN Smile 

g Description 

H 

The specified line must be within the same program or subprogram as the GOTO statement. If 

the specified statement is declaratory (for example, DIM, REM, or DATA), the program 
branches to the next executable statement. 

When GOTO is used after THEN or ELSE in an I F...THEN (...ELSE) statement, the GOTO 
keyword can be omitted. 

Related Keywords 

GOSUB, IF. ..THEM. ..ELSE, OM...GOSUB, ON. ..GOTO 



2-160 Keyword Dictionary 



GRAD 



Keyboard Executable 
Programmable 

In an IF—THEN 



The GRflD statement sets grads as the unit in which angles are measured. 



(grad) — »- 

Description 

When GRflD is executed, all angle parameters in statements and functions are interpreted as 
grads. (There are 400 grads in a circle.) All functions returning an angle return a value in 
grads. 

The angle mode of a program is global. When a subprogram is called, the current angle mode 
is carried into the subprogram. If a subprogram changes the angle mode and then returns to 
the main program, the new mode is carried back to the main program. 

Related Keywords 

DEG, RHO 



G 
H 
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G 
H 



GRAPHICS 



Keyboard Executable 

Programmable 

In an IF...THEN 



The G R R P H I C S statement displays the contents of graphics CRT memory. 



(graphics) — *■ 

Description 

The display must be the current PLOTTER IS device. 

The G R R P H I C S statement has no effect on the contents of alpha or graphics CRT memory. 
The G R fl P H I C S and R L P H fl statements allow you to alternately view the graphics and alpha 
displays without affecting display memory. 

Related Keywords 

ALPHA 
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GRID 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The G R I D statement draws a grid pattern onto the plotting area using the current line type 
and pen number. 







GRIC 


7\ 






















U 














, 


i * 


^ ^ 


x-tick 
spacing ^ 


> ) — ^ 


y-t ick 
spacing 




























/ 












wTV-^ 


x-intersect ion 


-CO- 


y-intersect ior 






«-^j » 


J 






















/■ 
















l^~v^ 


x-grid 
spacing 


— ^i » ) ^ 


y-grid 
spac ing 




^■i t j — 


Lq- 




) 
















minor tick 
size 





Item 


Description 


Range 


x-tick spacing 
y-tick spacing 
x-intersection 
y-intersection 
x-grid spacing 

y-grid spacing 

minor tick size 


numeric expression, interpreted in current units (default=0, 
no ticks) 

numeric expression, interpreted in current units (default=0, 
no ticks) 

numeric .expression interpreted in the current x-axis units 
(default = lower-left corner) 

numeric expression interpreted in the current y-axis units 
(default = lower-left corner) 

numeric expression, rounded to an integer, specifying the 
number of tick intervals between vertical grid lines 
(default=1) 

numeric expression, rounded to an integer, specifying the 
number of tick intervals between horizontal grid lines 
(default=1) 

length of a minor tick, in graphics units (default = 2) 


— 



G 
H 
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...GRID 



Examples 

GRID 5, 18 

G RID 5 ., 1 S , ! :: ! c r o s s , Y c r o s s 

G RID t (. 1 > , t < £ > , 3 , 30,2,4,3 

Description 

The grid is drawn across the entire plotting area using the current line type. Grid lines are 
drawn symetrically from the intersection of the two axes such that a grid line on each axis 
corresponds with the origin. 

The x- and y- tick spacing parameters specify the distance between tick marks on each axis. 
Negative numbers are interpreted as positive values by taking the absolute value. The default 
value of draws no ticks. 

The x-intersection parameter specifies, in current x-axis units, the point where the x-axis inter- 
sects the y-axis. The y-intersection parameter sepcifies, in current y-axis units, the point where 
the y-axis intersects the x-axis. 

The x- and y- grid spacing parameters specify the number of intervals between grid lines. For 
example, a major count of 4 means that every fourth tick is a grid line. The default value of 
one draws each tick as a grid line. 

The minor tick size parameter specifies the length of the ticks in graphics units. The default 
length is 2 GU's. 

If G R I D is executed without parameters, the number of grid lines drawn depends on the cur- 
rent scaling. 

Related Keywords 

RKES, LGRID, LINE TYPE 
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GSTORE 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The GSTORE statement stores the contents of graphics display memory into a BASIC/GRAF 
file with the specified name. 



C GSTORE y 



■o 



HP-UX 
path name 



J 



Oi 



string 
expression 



Item 


Description 


Range 


file name 


literal; name of a file in the current working directory 


14 characters 
maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name 


— 



Examples 



H 



TORE "Filename" 
TORE FILE* 
STORE ",-Dir 1 .-- D i r 2 .-• f i lename 



I 
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...GSTORE 



Description 

If the file name is used alone (rather than as part of an HP-UX path name), the GSTORE 
operation uses the current working directory. 

When G S T R E is executed, the system searches the specified directory for a BASIC/GRAF file 
with the specified name. If the file is found, the current contents of the graphics display 
memory is stored in that file, overwriting the previous contents. If no such file is found, then 
the file is created. 

An error is returned if the file name exists with another file type. 

Related Keywords 

GLORD, MASS STORAGE IS 
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HALT 



Keyboard Executable 
Programmable 

In an IF...THEH 



The HALT statement terminates any currently active interrupt transfer. 



(halt) — - 



interface 
select code 



Item 


Description 


Range 


interface select 
code 


numeric expression, rounded to an integer 


3 through 10 



Examples 

HALT 7 
HALT Isc 



Description 

If HALT is executed with an interrupt transfer active and an EOT branch enabled, the branch 
will be taken. 

Interface-dependent action: 

■ HP-IB: Leaves the bus in the present state. 

■ Serial, BCD, and GPIO: Does not affect external lines. RESET or ABORT 10 may be neces- 
sary after a halt to return the handshake lines to the proper state of the next operation. 

■ HP-IL: Active controller: If a data transfer is in progress, a Not Ready for Data (NRD) is 
sent. If the interface is not involved in the transfer, RESUME can be used to continue the 
transfer. 

Non-controller: Leaves the loop in its present state. 

Related Keywords 

A BURT 10, OH EOT, RESET 
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HMS 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The HMS function converts a string in hours:minutes:seconds (HH:MM:SS) format to an inte- 
ger number of seconds. 



(hms) — *(7)- 



string 
argument 



o— 



Item 


Description 


Range 


string argument 


string expression 


(see 
Description) 



Examples 



DISP HMS-:: "09 : 55 : 34" > 

LoopTime* = HMS<fl*&" : ":i:B$&" ; "&C$ 



Description 

G The string expression must evaluate to a string in the form HH:MM:SS, where: 



H 



HH (hours) consists of two digits in the range 00 through 99. 

MM (minutes) and SS (seconds) are each two digits in the range 00 through 59. 



Related Keywords 

DATE, HMS*, MDY, MDY*, TIME 
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HMS$ 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The HMS$ function converts a specified number of seconds to hours:minutes:seconds 
(HH:MM:SS) format. 



(hms$) — *(T)- 



numeric 
argument 



o 



Item 


Description 


Range 


numeric argument 


non-negative numeric expression, rounded to an integer, in- 
terpreted as number of seconds 


<360,000 



Examples 

Header *=HMS*<fl) 
DISP HMS*<12000> 



Description 

HMS* returns a string in the range 00:00:00 (HMS*03>) through 99:59:59 (HMS* < 359999 >). 

Related Keywords 

DATE, HMS, MYD, MYD*, TIME 



G 
H 
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HTD 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The HTD (hexadecimal-to-decimal) function interprets the string argument as the hexidecimal 
(base 16) representation of an integer and returns the numeric decimal equivalent. 



G^y—<^- 



string 
argument 



*Q> 



Item 


Description 


Range 


string argument 


string expression containing the base 1 6 representation of an 


characters must 




integer 


be through 9, A 
through F; cannot 
exceed the range 
of integers 



Examples 

Y=HTD<J*&"B" ) 

IF D=HTD<"fl"> THEN 780 

G 

h Related Keywords 

BTD, DTB*, DTH*, DTO*, OTD 
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IDRAW 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEM ■ 

The I D R A N statement draws a line from the current pen position to a position calculated by 
incrementing the current position by the specified x-and y-increments. 



(idraw)- 



x-increment 



o 



y-incnement 



Item 


Description 


Range 


x-increment 
y-increment 


numeric expression 
numeric expression 


— 



Examples 

I DRAW 10,58 

I DRAW RATI 0*10 



1 > 



Description 

IDRAW uses the current units mode (UU's or GU's) and line type. In UU's mode, lines cannot 
be drawn outside the plotting boundaries. In GU's mode, the plotting boundaries become 
equivalent to the graphics limits; therefore, lines can be drawn anywhere within the graphics 
limits. 

In both UU's mode and GU's mode, the logical pen can be moved outside the plotting area. ^ 
However, the physical pen cannot be moved beyond the plotting boundaries. 

Related Keywords 

DRAW, I MOVE, I PLOT, LINE TYPE, PLOT 
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IF THEN (ELSE) 



Keyboard Executable D 
Programmable ■ 

In an IF...THEH D 

The IF. ..THEN. ..(ELSE) statement causes conditional branching to the specified program line, 
based on the value of a relational or numeric expression. 



V I F ) I ** expression T~ * \THENy 



* j expression 
I relational 



expression 



statement 



line number 



i Lhw> 



line label 



statement 



line number 



line label 



I 

K 



Item 


Description 


Range 


relational 


an expression comparing two numeric or string expressions 


— 


expression 


using relational operators (=, <, >, < = , > = , <> or #). 




numeric 


evaluated as true if non-zero and false if zero 


— 


expression 






statement 


a programmable statement allowable "In an IF. ..THEN" 


refer to individual 
keyword legal us- 
age tables 


line number 


integer constant identifying a program line 


1 through 65,535 


line label 


name of a program line 


any valid name 
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...IF THEN (ELSE) 



Examples 

IF SI H < fi ng le) THE N D r a w Line 

IF Var iable<5 THEN 200 ELSE PRINT Variable 

Description 

When the expression following I F evaluates as true (non-zero), the portion of the statement 
following THEN is executed. When the expression following I F is false and the statement 
includes ELSE, the portion of the statement following ELSE is executed. When the expression 
following I F is false and the statement does not include ELSE, program execution proceeds to 
the next line. 

THEN and ELSE can be followed by: 

■ A line number or line label. This is interpreted as an implied GOTO. 

■ An executable statement. The statement must be one permitted "In an IF...THEN." If the 
executable statement is a GOSUB statement, the subroutine RETURN statement returns exe- 
cution to the line following the IF...THEN statement. 

■ A sequence of statements concatenated with @. 

Related Keywords 

GOSUB, GOTO 
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IMAGE 



Keyboard Executable □ 
Programmable ■ 

In an IF... THEN □ 

The I MRGE statement contains a format string referenced by D I SP US I HG, PR I NT US I NG, 
ENTER USING, OUTPUT USING, LABEL USING, or ENTER USING. The format string 
contains one or more field specifiers that describe the format of the incoming or outgoing data. 



(im^—^ST^ 



format string 



O 



repeat 
factor 




o 



field 
spec if ier 




o- 



*\^/ ** specifier \2J 



■o 



Item 


Description 


Range 


field specifier 

repeat factor 
format string 


literal consisting of one or more image specifiers (see syntax 
diagram, page 2-176) 

integer constant 

character string consisting of one or more field specifiers 


>0 
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Examples 

IMAGE 2ZCDDD .2D, 4tf, i2A,K 
IMAGE #, 4<M3*.3DE,2X,2<3fl>> 
IMAGE "Results = " , 2 < 4D . 2D , 3X > 

Description 

When the format string is part of an IMAGE statement, it is not enclosed in quotes. A format 
string is enclosed in quotes when it is part of a DISP USING, PRINT USING, 
LABEL USING, OUTPUT USING, or ENTER USING statement. 

The format string consists of one or more field specifiers, separated by delimiters. Most field 
specifiers designate a format for a particular item. Items are paired with their corresponding 
field specifiers from left to right. Certain field specifiers are not paired with an item. For exam- 
ple, X specifies a blank space between two items and / specifies an end-of-line sequence. 

A field specifier consists of one or more image specifiers. The image specifiers within a field 
specifier describe the format of one PRINT, DISP, LABEL, OUTPUT, or ENTER item. Items 
must match their field specifiers in type. For example, a string expression must be formatted 
with a field specifier appropriate for string data rather than one for numeric items. Certain 
image specifiers can be preceded by a repeat factor. For example, 4A specifies four character 
spaces. Certain image specifiers are used to control the EOL sequence sent to devices. 

If the format string is exhausted before the entire list of items is output, the format string is 
reused from the beginning. Extra field specifiers are ignored. 

If a field specifier is larger than a numeric item, the number is right-justified in the field. An 
IMAGE overflow occurs when a numeric item requires more digits spaces to the left of the 
decimal point than are specified. The overflow is reported as a warning (DEFAULT ON) or 
error (DEFAULT OFF). In the case of a warning, the default value assigned to the item may be 
incorrect. If a numeric item contains more decimal places than the field specifier, the number 
is rounded to fit the field. 

If a string item is longer than the field specifier, it is truncated to fit the field. If the string item 
is shorter than the field specifier, the string is left-justified in the field. 

I M A G E statements are declaratory; they are ignored if they are not referenced. 
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field specifier 



-0- 



-0— 



i , , ♦ — -0 



C^- 



^hmh ' 



£^ 



U®-J 



©*■ 



Mllp' 



L^L 



Msp 



X^L 



MmP 



-CqU 



H3- 



Jt®=T 



^SUP 



x: 



U0-J 






<H^zLhO 
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Table of Image Specifiers and Delimiters for DISP, PRINT, OUTPUT, and LABEL* 



Image 
Specifier 



Meaning 



R 
literal * 



Outputs a blank space. 

Digit position to left or right of the radix symbol. If the field to the left of the radix is larger 
than the number, the number is right-justified with leading blanks. If no sign is specified, a 
minus sign occupies one digit position. If a sign image is specified, the sign is positioned to 
the left of the left-most digit. 

Digit position to left of the radix symbol. If the field to the left of the radix is larger than the 
number, the number is right-justified with leading zeros. 

Digit position to left of the radix symbol. If the field to the left of the radix is larger than the 
number, the number is right-justified with leading asterisks. 

Strings are in compact format with no leading or trailing blanks. Numbers are in standard 
number format with no leading or trailing blanks. 

Character position for a string character; When the specified field is larger than the string, 
characters are left-justified. 

Outputs a value as one 8-bit byte of data. Values outside the range through 255 are 
reduced MOD(256). Numbers outside the range through 32,767 return the character I. 
Numbers are rounded to the nearest integer.* 

Outputs a value as two, 8-bit bytes of a 1 6-bit word. The most significant byte is output 
first. Numbers outside the range -32,768 through 32,767 uses 32,767. Negative numbers 
are output in 16-bit 2's complement format.* 

Radix; specifies a decimal point in that postion. 

Radix; places a comma in that position. 

String constant consisting of any of the following: keyboard characters, the CHR$ func- 
tion, and metacharacter sequences. The literal image is output without quotation marks. 



* This table applies to formatted DISP, PRINT, OUTPUT, and LABEL. See ENTER for additional information. 

+ When output is directed to the printer or display, the character(s) with decimal codes corresponding to the data bytes are 
output. 

* Literal images cannot be used with OUTPUT USING. 
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...IMAGE 



Table of Image Specifiers and Delimiters for DISP, PRINT, OUTPUT, and LABEL* 
(Continued) 



Image 
Specifier 



Meaning 



Digit separator; places a comma in that position. Comma is output only if digits on both 
sides of the separator are output. 

Digit separator; places a period in that position. Period is output only if digits on both sides 
of the separator are output. 

Exponential format; exponent consists of three digits plus sign. 

Exponential format; exponent consists of two digits plus sign. 

Sign; + or -. 

Sign; blank or -. 

Literal; outputs characters enclosed between quotes. 

Image specifer or delimiter; performs a carriage return/line feed. 

Placed at beginning of format string to suppress output of an end-of-line sequence. 



Related Keywords 

DISP, ENTER, PRINT, OUTPUT 
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IMOVE 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN I 

The I M V E statement lifts the pen and moves it from the current position to a position calcu- 
lated by incrementing the current pen position by the specified x- and y-displacements. 



(imove) - 



x-increment 



o 



y-increment 



Item 


Description 


Range 


x-increment 
y-increment 


numeric expression, interpreted in the current units 
numeric expression, interpreted in the current units 


— 



Examples 

IMOVE 5., 1@ 
IMOVE fl-10,B 



Description 

I MOVE uses the current units mode (UU's or GU's). The physical pen cannot move beyond the 
plotting boundaries (equivalent to the graphics limits in GU's mode). However, the logical pen 
can be moved beyond the plotting boundaries or graphics limits. 

Related Keywords 

DRAW, I DRAW, I PLOT, LINE TYPE, MOVE, PLOT 
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INF 

The INF function returns machine infinity, the largest positive REAL number. 

Examples 

DISP INF 

Related Keywords 

EPS 
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INIT 



Keyboard Executable ■ 
Programmable □ 

In an IF...THEN D 



The INIT command initializes the BASIC program currently in memory. 



(init) »- 

Description 

Initializing a program: 

■ Erases variable assignments made from the keyboard. 

■ Allocates memory to all program variables and assigns them values of and the null string. 

■ Checks the program for prerun errors; for example, referencing a nonexistent line, duplicate 
user-defined functions, and dimensioning the same variable more than once. 

■ Sets the lowest numbered line as the first line to be executed when the program is run. 

■ Cancels any enabled event-initiated branching. 

■ Clears program flags. 

Refer to the table of Reset Conditions for additional information. 



Related Keywords 

CO NT, PAUSE, RUN 



I 
K 
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INPUT 



Keyboard Executable 
Programmable 

In an IF...THEH 



□ 



The INPUT statement is used to assign values entered from the keyboard to program 
variables. 



(input} 




I fc ^T^ ^Ibeginninc 
^V"V — position 



^ ~ position I ^Jy 



Item 


Description 


Range 


numeric name 
string name 
subscript 
beginning position 
ending position 


name of a simple numeric variable or numeric array 
name of a simple string variable or string array 
numeric expression, rounded to an integer 
numeric expression, rounded to an integer 
numeric expression, rounded to an integer 


any valid name 
any valid name 
1 through 65,530 
1 through 65,530 
1 through 65,530 



K Examples 



39 INPUT Var iablel , War iable2$, firrayl <2, 3> 

56 I NPUT fir r ay2$ < 3 > , fir r ay2$ C 4 > C 3 , 5 3 , fir r ay2$ < 6 > C 3 1 
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...INPUT 



Description 

Executing INPUT causes program execution to halt until a value has been entered from the 
keyboard for each input item. Items are separated by commas. The entire list of items must be 
entered at once. An error is returned if the number of items entered does not equal the num- 
ber of items listed in the input statement. 

Individual items must match the specified INPUT variable(s) in type (numeric versus string). 
The input statement can include simple numeric and string variables, numeric and string array 
elements, and substrings. Entries from the keyboard can include numbers, numeric expressions 
containing numbers and operators, and character strings. If quotation marks appear anywhere 
in the input string, they are regarded as part of the string. The null string can be assigned to 
an INPUT string variable only when the I H P U T statement contains only that item. 

When INPUT is executed, a question mark is displayed on the current alpha display line. A 
D I SP (US I NG) statement, executed just before the I NPUT statement, can be used to display a 
more informative prompt. The question mark appears on a separate line from the D I S P 
(USING) prompt unless that statement suppresses the end-of-line sequence. If the EOL se- 
quence is suppressed, the question mark is displayed on the same line as the prompt, 
immediately after the last character. The D I S P EOL sequence is suppressed by terminating the 
statement with a semicolon. The D I SP US I NG EOL sequence is suppressed by including the 
# image specifier in the format string. 

Live keyboard operations are not allowed while the program is halted at I N P U T . If a program 
is paused from the keyboard at an I H P U T statement, executing C N T resumes program execu- 
tion at the line following the I N P U T statement; the INPUT variables do not receive 
assignments. 

ON KEY#, ON KYBD, ON TIMER#, and ON ERROR branching are temporarily disabled dur- 
ing execution of an INPUT statement. 

Related Keywords 

LI NPUT 
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INT 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The I H T function returns the greatest integer less than or equal to the numeric argument. 



CE>-(I> 



numeric 
argument 



o 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 



DISP INT<35.77*X> 

IF K,--2=INT'::K,--2::' THEN PRINT "Variabl 



e X is E v e n 



Description 

The functions I N T and F L R perform identical operations. INT differs from I P for negative 
arguments. For example, IP (-5. 6) returns -5, whereas INT<-5.6> returns —6. 

The FLOOR function is identical to INT. 

Related Keywords 

1 FLOOR, FP, IP 
K 
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INTEGER 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN □ 



The INTEGER statement declares and reserves memory for integer variables. 



(integer) - 



O 



numeric 



o. 



*H7)- H=n — L -<))- j 



Item 


Description 


Range 


numeric name 
upper bound 


name of a simple numeric variable or numeric array 
integer constant 


any valid name 
1 through 65,535 



Examples 



I N T E G E R Inteqe r '■.■' a r i a b 1 e , IntegerR r r a m 1 < 1 @ .':> , I n t eg erflr r a m 2 
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■■■INTEGER 

Description 

All numeric variables are REAL unless declared SHORT or INTEGER. 

When the numeric variable name is used with one or two upper bound(s) enclosed in paren- 
theses, the variable is dimensioned to be a one- or two-dimensional array. The default lower 
bound of the array is 0. The OPT I ON BASE statement is used to set the lower bound equal to 
1. 

When a REAL number is assigned to an INTEGER variable, the number is rounded. Overflow 
occurs if the value of the number is outside the range of integers. 

When variables are passed to a subprogram by address, the precision declarations accompany 
the variable into the subprogram. 

Related Keywords 

DIM, SHORT, REAL 
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IOBUFFER 



Keyboard Executable 
Programmable 

In an IF...THEH 



The I E U F F E R statement declares a string variable as an I/O buffer. 



(iOBUFFER) H S namC 



Item 


Description 


Range 


string name 


name of a simple string variable 


any valid name 



Examples 



IOBUFFER OneDollar* 



Description 



The previously dimensioned length of the string is the size of the buffer. When the buffer is 
declared, four pointers are established for controlling buffer activity. In addition, four status 
registers and two control registers provide for monitoring the buffer pointers: 



I/O Buffer Status Registers 


Register 


Default Value 


Function 


SRO 


1 


Buffer empty pointer 


SR1 





Buffer fill pointer 


SR2 





Active-in select code 


SR3 





Active-out select code 
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...IOBUFFER 



I/O Buffer Control Registers 



Register 


Default Value 


Function 


CRO 
CR1 


1 



Buffer empty pointer 
Buffer fill pointer 



The buffer empty pointer has an initial value of 1. Its value changes when data bytes are 
removed from the buffer: 

1. A byte of data is accessed by an ENTER or TRANSFER statement. 

2. The buffer empty pointer is incremented by 1. 

The value of the buffer empty pointer is stored in control/status register 0. The value of the 
pointer is restored to 1 when the buffer is empty. 

The buffer fill pointer has an initial value of 0. Its value changes as bytes of data are placed 
in the buffer: 

1. The buffer fill pointer is incremented by 1. 

2. A byte of data is placed in the buffer. 

The value of the buffer fill pointer is stored in control/status register 1. The value of the 
pointer is restored to when the buffer is empty. 

The active-in select code equals when there is no active input TRANSFER operation for the 
buffer. When an input TRANSFER for the buffer is active, the active-in select code equals 
the interface select code of the source interface. The value of the active-in select code is 
stored in control/status register 2. 

The active-out select code equals when there is no active output TRANSFER operation for 
the buffer. When an output TRANSFER for the buffer is active, the active-out select code 
equals the interface select code of the destination interface. The value of the active-out 
select code is stored in control/status register 3. 



2-188 Keyword Dictionary 



...IOBUFFER 



A buffer is empty when the buffer empty pointer equals the buffer fill pointer plus one. A 
buffer is full when the buffer fill pointer equals the dimensioned length of the string variable. 
When a buffer becomes empty, the buffer fill pointer is reset to and the buffer empty 
pointer is reset to 1 . The active-in select code and active-out select code are not affected by the 
buffer becoming empty. When a buffer becomes empty data in the buffer is not lost. The data 
can be accessed again by changing the value of the buffer fill pointer. 

If a conversion table is to be used for a buffer, the C N V E R T statement must be executed after 
the buffer has been declared with an 1 B U F F E R statement. 

Related Keywords 

CONTROL, CONVERT, ENTER, OUTPUT, STATUS, TRANSFER 
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IP 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The I P function returns the integer part of the numeric argument. 



QQ-<(> H ■ n n U B m umVn C t | ~ »Q) 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 

PRINT IP (number> 
C o u nter = I P ( X +3,6 



Related Keywords 

FLOOR, FP, I NT 
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IPLOT 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The I P L T statement moves the pen from the current pen position to a position calculated by 
incrementing the current pen position by the specified x- and y-displacements. The optional 
pen control parameter specifies the up/down status of the pen. 



(iPLOTj — » x-increment 



y-increment 



L.Y7V-J p^" \—J 

^ n control | 



Item 


Description 


Range 


x-increment 
y-increment 
pen control 


numeric expression, interpreted in the current units 

numeric expression, interpreted in the current units 

numeric expression, rounded to an integer (default = + 1; pen 
lowered after move) 


— 



Examples 

IPLOT X,Y,P 
IPLOT 5., 18 
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...IPLOT 



Description 

IPLOT uses the current units (GU's or UU's) and line type. In UU's mode, lines cannot be 
drawn outside the plotting boundaries. In GU's mode, the plotting boundaries are equivalent 
to the graphics limits; therefore, lines can be drawn anywhere within the graphics limits. 

In both UU's mode and GU's mode, I P L T can position the logical pen outside the plotting 
area. However, IPLOT cannot position the physical pen outside the plotting boundaries. If 
none of the line is inside the current plotting area, the physical pen is not moved, but the 
logical pen position is updated. 

The optional pen control parameter specifies the up and down position of the pen as follows: 

Pen Control 



Pen Control Parameter 


Pen Action 


positive, even 
positive, odd 
negative, even 
negative, odd 


pen moved and then lifted 
pen moved and then lowered 
pen lifted and then moved 
pen lowered and then moved 



If no pen control parameter is specified, the up/down status of the pen before I P L T is 
executed determines whether the pen is up or down as it moves. If the pen is up, it is lowered 
when it reaches its new position. 

Related Keywords 

LINE TYPE, PLOT, RPLOT 
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KEY LABEL 



Keyboard Executable I 
Programmable I 

In an IF...THEN I 

The K E Y LABEL statement displays the key labels assigned to the user-defined (special func- 
tion) keys during program execution. 



( key label"") — *- 

Examples 

IF KCode=150 THEN KEY LABEL 

Description 

When it is executed in a program, K E Y LABEL displays the key labels assigned by N K E Y # 
statements in the program. 

Executing K E Y LABEL from the keyboard displays the key labels for the typing aids assigned 
to the user-defined keys. The typing aid assignments are changed by executing OH KEY# 
from the keyboard. 

Related Keywords 

OFF KEY*, ON KEY* 
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LABEL 



Keyboard Executable 
Programmable 

In an IF...THEN 

The LABEL statement plots alphanumeric labels on the plotting device at the current 
pen postion. 



(label) 



Trailing punctuation 
ignored with USING. 




olumn— H)) / TAB not allowed 

I \LS with USING. 
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Item 


Description 


Range 


IMAGE line 


integer constant identifying an I M A G E statement 


1 through 65,535 


number 






IMAGE line label 


name identifying an I M A G E statement 


any valid line 
name 


format string 


string expression containing one or more field specifiers (see 
I M A G E statement for syntax) 


— 


column 


numeric expression, rounded to an integer 


-99,999 through 
99,999; negative 
numbers are inter- 
preted as 1 


numeric 


— 


— 


expression 






string expression 


— 


— 



Examples 



LABEL "Velocity <m. 
LABEL A$ 

LABEL USING "5Z.2D 
LABEL USING Format 



E a r n i ng s 
Y 1 a b e 1 $ & " (. m i 1 1 i o n : 



Description 

Labels can be positioned anywhere within the graphics limits. They are drawn using the cur- 
rent pen and line type 1. (The current line type remains in effect for lines and axes.) 

LABEL Without Using. Simple LABEL standard number format (see glossary) for numeric 
items, and displays numeric and string items in either of two field widths: 

■ When label items are sparated by semicolons, they are drawn in narrow format with a lead- 
ing blank or minus sign. Strings are output with no leading or trailing blanks. 

■ When label items are separated by commas, they are drawn in wide format, left-justified in 
21 -column fields. Items longer than 21 characters occupy more than one field. 
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...LABEL 



When the TAB function is included as a label item, the cursor moves to the designated col- 
umn. Negative column numbers are treated as TAB(l). Column numbers greater than the line 
length are reduced MOD (line length). When TAB is used to control format, label items should 
be separated by semicolons; using commas causes output to be displayed in wide format. 

After all the label items have been drawn, an end-of-line sequence is sent to the logical pen, 
moving the pen to a position underneath the first character of the label. The EOL sequence 
can be suppressed by including a comma or semicolon after the last label item. 

LABEL Appearance and Position. The following statements control the appearance of 
labels: 

■ The CS I ZE statement determines the height, aspect ratio, and slant of the label characters. 

■ The L R G statement determines the position of the label with respect to the pen position at 
the time the LRBEL statement is executed. 

■ The LDIR statement determines the angle at which the label is drawn. 

Formatted Labels. The LABEL U S I H G statement uses a format string contained in the 
statement itself or in an accompanying IMAGE statement to format the output. The format 
string, consisting of one or more field specifiers separated by delimiters (, or ..-), is used from 
left to right. Label items are paired with their corresponding field specifiers. Certain field spec- 
ifiers do not use a label item (for example, X). If the format string is exhausted before all the 
display items have been processed, the format string is reused from the beginning. Extra field 
specifiers are ignored. If a field is larger than the numeric item, the number is right-justified in 
the field. A warning is issued if the number is larger than the field. (A minus sign requires a 
digit position if M or S is not included in the field specifier.) Numbers are rounded to the 
number of decimal places indicated by the field specifier. 

Refer to I M A G E for the syntax of the format string. 

Related Keywords 

CSIZE, IMAGE, LDIR, LORG 
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LAXES 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

L AXES (label axes) statement draws a pair of axes and labels them with the current scale units 
at each major tick mark. 



(laxes) - 



l J x-tit 




x-intersect ic 



on — */ » ) » y-in 



itersect ion 




x-rtic 

COL 



a3or " I fc^T^ ^1 y~ ma J° 

unt >»_»/ count 



>. ^f\ ^1 major tick 

^vL/H____ii££__ 



Item 


Description 


Range 


x-tick spacing 


numeric expression, interpreted in the current units 


— 


y-tick spacing 


numeric expression, interpreted in the current units 
ideiault=Q.' no ticks) 


— 


x-intersection 


numeric expression, interpreted in the current units 
(default = lower-left corner) 


— 


y-intersection 


numeric expression, interpreted in the current units 
(default = lower-left corner) 


— 


x-major count 


numeric expression, rounded to an integer, specifying the 
number of tick intervals between major tick marks on the 
x-axis (default=1) 




y-major count 


numeric expression, rounded to an integer, specifying the 
number of tick intervals between major tick marks on the 
y-axis (default = 1) 




major tick size 


length of a major tick, in graphics units 


— 
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Examples 



LAKE 
LflXE 
LflXE 



<. 'A m a x - y. m i n > .-- 1 8 , 

1 .1 Ll .i X S 6 C t ,i 'f S 9 C t 

1,2, 49,20,3, 1 



Description 

The axes are drawn across the entire plotting area using the current line type. Tick marks are 
drawn symmetrically from the intersection of the two axes such that a major tick mark on 
each axis corresponds with the origin. Labels are drawn using line type 1. They are placed 
outside the plotting boundaries below the x-axis and to the left of the y-axis. 

The x and y tick-spacing parameters specify the distance between tick marks on each axis. 
When the tick-spacing parameter is positive, the labels are drawn perpendicular to the axis. 
When the tick-spacing parameter is negative, the labels are drawn parallel to the axis. 

The x-intersection parameter specifies, in current x-axis units, the point where the x-axis inter- 
sects the y-axis. The y-intersection parameter specifies, in current y-axis units, the point where 
the y-axis intersects the x-axis. 

The x- and y-major count parameters specify the number of intervals between major ticks. For 
example, a major count of 4 means that every fourth tick is major tick. The default value of 1 
draws each tick as a major tick. 

The major tick size parameter specifies the length of the major ticks in graphics units. The 
default length is 2 GU's. Minor ticks are always Vi the size of major ticks. 

Related Keywords 

AXES, GRID, LGRID, LINE TYPE 
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LBND 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The LBHD function returns the lower bound of the specified array. 



(lbnd)— »{T)— 41 



array 
lame 



o 



subscr ipt 



<z> 



Item 


Description 


Range 


array name 
subscript 


name of a one- or two-dimensional numeric array 
numeric expression, rounded to an integer 


any valid name 
1 through 2 



Examples 

DISP LBND Car ray, 1) 
MAT S=B<LBND<B, 1 > : 5, 3) 

Description 

LBND always returns the current option base. The second parameter (subscript) is ignored. 
(The parameter is used with the corresponding UBND function to specify which upper bound 
is to be returned in the case of two-dimensional arrays.) 

Related Keywords 

UBND 
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LDIR 



Keyboard Executable 
Programmable 

In an IF...THEH 

The LDIR (label direction) statement specifies the angle at which labels are drawn. 



( ldir} - 



angle 



<H 



Item 


Description 


Range 


angle 

run 
rise 


numeric expression, interpreted according to the current 
trigonometric mode 

numeric expression, interpreted in the current scale units 

numeric expression, interpreted in the current scale units 


— 



Examples 

LDIR 69 

LDIR fl (. I > , fl < I > * 1 



Description 

The specified angle is interpreted according to the current trigonometric mode (DEG, RRD, or 
GRflD). This angle measures the counterclockwise rotation between the horizontal axis and the 
label direction. 

The run and rise parameters determine the direction of a vector drawn in the new label 
direction. 



Related Keywords 

DEC, GRflD, LABEL, PDIR, RflD 
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LEN 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The L E H (length) numeric function returns the number of characters in the string argument. 



0^0— »Q-~ \ aPBum^nt \ —Q) 



Item 


Description 


Range 


string argument 


string expression 


— 



Examples 



Y=LEN<fl*> 

IF LEhKStr ing *::■<= 10 THEN S t r ing*=S tr ing*& 



Description 

The value returned is the current number of characters in the string, regardless of its dimen- 
sioned length. The length of the null string is 0. 
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LET 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN I 

The LET statement assigns values to variables. The keyword is optional in program state- 
ments. Assignments from the keyboard must include the keyword. 




LET* 



O 



numeric 
name 



u<<> 




subscript 



^/L~N fc numeric 
\^_y expression 



<D- J 



string 
name 



o 



KD-H 




subscript 



>. fc fT^ fc |beginnin 
^yly " ^position 



hrK^ 



/C > \__J string 

\^_y H expression 



*GH 




ending 
position 



* Keyword is optional when 
statement is executed in a program. 



Item 


Description 


Range 


numeric name 
string name 
subscript 
beginning position 
ending position 


name of a simple numeric variable or numeric array 
name of a simple string variable or string array 
numeric expression, rounded to an integer 
numeric expression, rounded to an integer 
numeric expression, rounded to an integer 


any valid name 
any valid name 
1 through 65,530 
1 through 65,530 
1 through 65,530 
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Examples 

LET Var iable=5*X 
Svar iable*="fiBC"&H$ 
LET fl<2,4>, B<2,5>=7 
Str ing 1*<3>C2, 5D="fghi" 

Description 

LET assigns the numeric or string value on the right side of the equation to one or more 
variables on the left side. Any variables used on the right side must previously have been 
assigned. 

A REAL expression is rounded when assigned to an INTEGER or SHORT variable. The REAL 
expression must evaluate to a number within the INTEGER or SHORT range. 

When a string expression is assigned to a string variable, the expression must evaluate to a 
sequence of characters less than or equal to the dimensioned size of the string variable. When 
a string expression is assigned to a substring, excess characters are truncated. For example, 
h$L 1 , 2 3="abcde" assigns the characters ab to the first two characters of variable A$. 

The following rules apply to string assignments: 

■ The expression on the right must evaluate to a string less than or equal to the dimensioned 
size of the variable. 

■ When an expression is assigned to a substring, excess characters are truncated. For example, 
f\$Ln,n + 1l=" abcde" assigns ab to positions n and n+1 of A$. 

■ When a substring reference contains only the beginning position, characters are entered into 
the string starting at that position. For example, fl*Cn]="qrs" assigns qrs to character 
positions n, n+1, and n+2. 

■ f\$Ln, /7ll=" a be" assigns a to position n. 

■ A substring in which the ending position is one less than the beginning position specifies 
the null string. For example, fl $ = B $ C 4 , 3 1 is equivalent to Fi $ = " " . 

■ Substring expressions H$Ln+2,nl, f\$Ln + 3., nl, etc., return an error. 
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LGRID 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The L G R I D statement draws a grid within the current plotting area and labels each grid line 
with the current scale units. 



(lgrid) - 



v-fcj x_tick L_fc/TV-*J y _tic|< 

spacing >*»!• spacin 




x-intersect ic 



on — m/ » J — * 



y-intersect ion 




x-grid 
spacing 



V^V/ spacin 



^ „ f ~ \ ^| minor tick 
^*\'y~ n size 



Item 


Description 


Range 


x-tick spacing 
y-tick spacing 
x-intersection 
y-intersection 
x-grid spacing 

y-grid spacing 

minor tick size 


numeric expression, interpreted in current units (default=0, 
no ticks) 

numeric expression, interpreted in current units (default=0, 
no ticks) 

numeric expression interpreted in the current x-axis units 
(default = lower-left corner) 

numeric expression interpreted in the current y-axis units 
(default = lower-left corner) 

numeric expression, rounded to an integer, specifying the 
number of tick intervals between vertical grid lines 
(default=1) 

numeric expression, rounded to an integer, specifying the 
number of tick intervals between horizontal grid lines 
(default = 1) 

length of a minor tick, in graphics units (default = 2) 


— 
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L 



...LGRID 



Examples 

LGRID 5,10 

L G R I D X s p a c e , K s p a c e * 2 ., X sect , Y sect 

L G RID 5,1 , 3 , 30,2,4,3 

Description 

The grid is drawn across the entire plotting area using the current line type. Grid lines are 
drawn symmetrically from the intersection of the two axes such that a grid line on each axis 
corresponds with the origin. Each grid line is labeled with the current scale units. Labels are 
drawn outside the plotting boundaries below the x-axis and to the left of the y-axis using line 
type 1. 

The x- and y-tick spacing parameters specify the distance between tick marks on each axis. 
When the tick-spacing parameter is positive, the labels are drawn perpendicular to the axis. 
When the tick-spacing parameter is negative, the labels are drawn parallel to the axis. 

The x-intersection parameter specifies, in current x-axis units, the point where the x-axis inter- 
sects the y-axis. The y-intersection parameter sepcifies, in current y-axis units, the point where 
the y-axis intersects the x-axis. 

The x- and y-grid spacing parameters specify the number of intervals between grid lines. For 
example, a major count of 4 means that every fourth tick is a grid line. The default value of 
one draws each tick as a grid line. 

The minor tick size parameter specifies the length of the ticks in graphics units. The default 
length is 2 GU's. 

If L G R I D is executed without parameters, two labeled axes are drawn. 

Related Keywords 

AXES, GRID, LflXES, LINE TYPE 
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LGT 



Keyboard Executable 
Programmable 

In an IF...THEH 



The LGT function returns the base 10 logarithm of the argument. 



(J^Q— +(S)— H a^'m Vn't h +O) 



Item 


Description 


Range 


numeric argument 


numeric expression 


>0 



Examples 

fl < 2 > = ft < 1 >*LGT<T> 

IF LGT<X>=2 THEN DISP 

Related Keywords 

LOG 
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LIMIT 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The LIMIT statement specifies the graphics limits of the plotting device and activates the 
graphics default conditions (see glossary). The graphics limits must be within the physical 
limits of the plotting device. 



(limit)- 



U 



*\'J •" x-max *\'J *" 



o 



Item 


Description 


Range 


x-min 
x-max 
y-min 
y-max 


numeric expression, interpreted as millimeters 
numeric expression, interpreted as millimeters 
numeric expression, interpreted as millimeters 
numeric expression, interpreted as millimeters 


— 



Examples 



LIMIT 0, 125,8,75 

LIMIT fl<l),fl<£),fi<3>,fl<4> 
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...LIMIT 



Description 

The LIMIT parameters specify the coordinates, in millimeters, of the lower-left and upper- 
right corners of the plotting area. The origin is the lower-left corner of the physical limits. The 
parameters must specify coordinates within the physical limits of the plotting device. When 
LIMIT is executed, the physical and logical pens are moved to the lower left corner of the 
graphics limits — (0,0) in GU's. 

Executing LIMIT overrides any previously set graphics limits; the new limits remain in effect 
until a new LIMIT statement is executed, or until the default graphics limits are activated (see 
glossary) by reset or by executing a PLOTTER IS statement. 

When LIMIT is executed without parameters, program execution halts until coordinates are 
entered from the plotting device. 

The order of LIMIT parameters can be changed to produce reflected graphics output: 

Reflecting Plots 



LIMIT Statement Parameters 


Effect 


x-max, x-min, y-min, y-max 
x-min, x-max, y-max, y-min 
x-max, x-min, y-max, y-min 


reflects output across y-axis 
reflects output across x-axis 
reflects output across origin 



Labels are reflected by using negative CSIZE parameters (refer to CSIZE). 

Related Keywords 

CSIZE, LOCATE, PLOTTER IS, RATIO, SCALE, SETGU, SETUU, SHOW 
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LINE TYPE 



Keyboard Executable 
Programmable 

In an IF...THEN 



The LINE TYPE statement selects the line type for drawing lines, axes, frames, and grids on 
the graphics display. For peripheral plotters and some displays, LINE T Y P E also provides for 
selecting the repeat length of the line pattern. 



( LINE TYPE ) *g 



:ype 
jmber 



K> 



repea 
length 



^7 



Item 


Description 


Range 


type number 
repeat length 


numeric expression, rounded to an integer (default = 1) 

numeric expression, rounded to an integer, interpreted as 
GU's (default=4 GU's for peripheral plotters) 


— 



Examples 

LINE TYPE 5 
LINE TYPE fl, 10 
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Description 

Line types 1 through 8 are available on the graphics display. Type numbers outside this range 
default to line type 1. 

The repeat length is always expressed in GU's, regardless of the current units. The default 
value of the display repeat length is machine-dependent. The repeat length parameter may be 
ignored by some display devices. 

Display Line Types 



Type Number 








Pattern 






1 

2 












Qndpoints 


• 








• 


3 


• 


• 


• 


• • 


• 




4 










- 




5 
6 
7 































8 















Related Keywords 

PEN 
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LINPUT 



Keyboard Executable 

Programmable 

In an IF...THEN 



The L I H P U T statement accepts alphanumeric input from the keyboard, interprets the input as 
a character string, and assigns the character string to the specified string variable. 



( LINPUT ) -[ T-*. 

L ^y^ ^Ipromptl fc /1TN J 
^V J* \ sting | -*\ J 



string 
name 



K<> 



O 



L w/T^ Ibeginning l *_{ T\ J 

^ H position I I ^^J 



*GH 



L^/TV_fcJ endin 9 

\ S V/ position 



Item 


Description 


Range 


prompt string 


literal composed of characters from the keyboard 


— 


string name 


name of a simple string variable or string array element 


any valid name 


subscript 


numeric expression, rounded to an integer 


1 through 65,530; 
maximum of two 
allowed 


beginning position 


numeric expression, rounded to an integer 


1 through 65,530 


ending position 


numeric expression, rounded to an integer 


1 through 65,530 



Examples 



LINPUT "Enter your data", f\$ 
LINPUT Variable* 
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Description 

When L I N P U T is executed, a prompt appears on the current line of the alphanumeric display 
and remains there until the LINPUT item is satisfied. If no prompt is specified, the default 
prompt ? is used. Using a null string for the prompt string suppresses the default prompt. 

The L I N P U T statement allows commas, quotation marks, and leading and trailing blanks in 
the character string assigned to the string variable. Unlike the INPUT statement, multiple in- 
puts and variable assignments are not allowed. 



Pressing ( return ) terminates data input. If no characters are entered, the null string is as- 
signed to the string variable. 

Event-initiated branching (OH KEY#, OH ERROR, OH KYBD, OH EOT, ON IHTR, 
OH TIMEOUT, OH TIMER#) is disabled while LINPUT is being executed. 

Related Keywords 

INPUT 
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LIST 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The LIST statement lists the current program or subprogram in system memory on the alpha 
display. 



(list> 



^ 



beginning 
line number 



>^_/ line nun 



ig 
jmber 



Item 


Description 


Range 


beginning line 
number 

ending line 
number 


integer constant 
integer constant 


1 through 65,535 
1 through 65,535 



Examples 

LIST 

LIST 40,48 
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Description 



The beginning line number and ending line number specify the portion of the program to be 
listed. If no ending line number is specified, listing begins at the beginning line number and 
fills the display. 

When both parameters are omitted, the listing fills the screen. Listing begins at the first line of 
the program except in the following cases: 

■ When program execution has been halted by a program error, by execution of PAUSE, or by 
pausing the program from the keyboard, listing begins at the line at which execution halted. 

■ Executing LIST repeatedly displays successive segments of the program. 

Related Keywords 

PL I ST 
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LOAD 



Keyboard Executable ■ 
Programmable □ 

In an IF...THEH □ 

The LOAD command retrieves the specified BASIC/PROG file and loads the program into 
system memory. 



(L0Ap) - T ->{ ir ) 



file 
name 



HP-UX 
path name 



str ing 
expression 



<h 



Item 


Description 


Range 


file name 


literal; name of a file in the current working directory 


14 characters 
maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name 


— 



Examples 



LOAD "Filename" 

L A D " .-•• v o 1 1 .-- file n a m e " 

LOAD " .-- Direct o r y 1 / Direct o r y 2 .•■- file n a rn e 
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Description 



If the file name is used alone (rather than as part of an HP-UX path name), the LOAD opera- 
tion uses the current working directory. 

LORD scratches any BASIC programs, subprograms, and variable assignments in memory. 

LORD cannot be used to load subprograms. FIHDPROG retrieves subprograms and makes 
them available for editing. 

Related Keywords 

FIHDPROG, MASS STORAGE IS, STORE 
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LOADBIN 



Keyboard Executable 
Programmable 

In an IF—THEN 



The L fl D B I N statement retrieves the specified binary file, enters it into BASIC memory, and 
makes all the binary program entry points available to C A L L B I N . 



( LOADBIN } ~r-*"C^) 



file 
name 



rOi 



HP-UX | J 

path name 



string 
expression 



Item 


Description 


Range 


file name 


literal; name of a file in the current working directory 


14 characters 
maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name 


— 



Examples 



LOADBIN "Gdrau" 

L A D B I N " m y 1 og o n ,--g d r a w " 

LOADBIN FILE* 

Description 

L A D B I N loads the binary program without scratching BASIC memory. Program entry points 
are not checked; linking must be done outside the BASIC environment. 

Related Keywords 

CALLBIN, SCRATCHBIN 
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LOCAL 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The L C fl L statement returns one or more an instruments to local control after they have been 
placed under remote control by the REMOTE statement. 



O 



(^L)J--[]2|f 



Item 


Description 


Range 


device selector 


numeric expression, rounded to an integer (see glossary) 


— 



Examples 



LOCAL 703,706 

LOCAL 1 00* I sc +flddr e; 
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Description 

If two or more device selectors are specified, they must be valid combinations of an interface 
select code and primary address; the devices must be at the same interface select code. 

Interface-dependent action: 

■ HP-IB: 

If the computer is System Controller and the device selector is an interface select code, 
Remote Enable (REN) is set false. 

If the computer is Active Controller and the device selector contains a primary address, the 
interface addresses the specified device(s) and sends Go To Local (GTL), leaving ATN true. 
(Use RESUME to set ATN false.) 

If the device is in remote with local lockout set, the device must receive GTL or have REN 
set false to be returned to local control. 

■ Serial, BCD, GPIO: Error. 

■ HP-IL: 

The computer must be active controller. 

If the device selector in an interface select code, Not Remote Enable (NRE) is sent. 

If the device selector includes a primary address, Unlisten (UNL), Listen Address n (LADn), 
and Go To Local (GTL) are sent. 

If the device is in remote with local lockout set, the device must receive Go To Local (GTL) 
or Not Remote Enable (NRE) before it returns to local control. 

Related Keywords 

LOCAL LOCKOUT, REMOTE 
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LOCAL LOCKOUT 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The LOCAL LOCKOUT statement sends the Local Lockout message (LLO), which prevents an 
operator from placing the specified device(s) under manual (local) control. 



( LOCAL LOCKOUT ) » | se ^ f 



face 
code 



Item 


Description 


Range 


interface select 
code 


numeric expression, rounded to an integer 


3 through 10 



Examples 

LOCAL LOCKOUT Isc 
LOCAL LOCKOUT 7 

Description 

The computer must be active controller. The LLO message is received by all devices on the 
interface. If a device is in the LOCAL state when LLO is sent, the message does not take affect 
until the device receives a Remote message and becomes addressed to listen. 

Interface-dependent action: 

■ HP-IB: ATN is left true. (If necessary, use RESUME to set ATN false.) Local Lockout remains 
in effect until the Remote Enable (REN) line is set false. 

■ HP-IL: Local Lockout remains in effect until the Not Remote Enable (NRE) command is 
sent. 

■ Serial, BCD, and GPIO: Error. 

Related Keywords 

LOCAL, REMOTE 
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LOCATE 



Keyboard Executable 
Programmable 

In an IF. ..THEN 



The LOCATE statement specifies plotting boundaries in graphics units (GU's). 



( LOCATE y 



^— »■ x-min *( i J— —» x-max +4 > J * y-min +4 » J »■ y-max ' 



Item 


Description 


Range 


x-min 


numeric expression, interpreted as GU's 


— 


x-max 


numeric expression, interpreted as GU's 


— 


y-min 


numeric expression, interpreted as GU's 


— 


y-max 


numeric expression, interpreted as GU's 


— 



Examples 

L C fl T E 2 .. S @ , 5 9 , 1 

L C fl T E 2 , 2 + X , 5 , 5 + Y 

Description 

The LOCATE parameters define the plotting boundaries in GU's. These boundaries replace 
any previously defined plotting boundaries. When the system is in UU's mode, no lines can be 
drawn beyond the plotting boundaries. However, labels can be drawn outside the plotting 
area and within the graphics limits. 

When LOCATE is executed prior to SCALE, MSCALE, or SHOW, the user units are mapped onto 
L the LOCATE-defined plotting area. If a CLIP statement is executed after LOCATE, the CLIP 
boundaries replace the LOCATE boundaries. 
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...LOCATE 



The LOCATE plotting boundaries are canceled when LIMIT, PLOTTER IS, or UN CLIP are 
executed. The SETGU statement deactivates the plotting boundaries; they are restored by ex- 
ecuting SETUU. 

When L C A T E is executed without parameters, program execution halts until plotting bound- 
aries are entered from the plotting device. 

The LOCATE parameters can be exchanged to reflect the plot (see LIMIT). 

Related Keywords 

CLIP, LIMIT, LOCATE, PLOTTER IS, SETGU, SETUU, UN CLIP 
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LOG 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The LOG numeric function returns the natural (base e) logarithm of the argument. 



G^)—<0— H ■ n r U H ZVn C t I — <)) 



Item 


Description 


Range 


numeric argument 


numeric expression 


>0 



Examples 

T=1/K*L0G{N1/N2> 

IF L0G<fi><=2 THEN 900 

Related Keywords 

EXP, LGT 
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LORG 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The LORG (label origin) statement specifies the position of labels relative to the current pen 
position. 



label 
position 



Item 


Description 


Range 


label position 


numeric expression, rounded to an integer (default = 1) 


1 through 9 



Examples 



LORG 
LORG 



I 
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■■■LORG 

Description 

Label positions outside the range 1 through 9 are interpreted as LORG 1. 

The following illustration shows the relationship between the label and the logical pen posi- 
tion. The numbers show the logical pen position before the label is drawn using the various 
label position numbers. 



Related Keywords 



LABEL, LDIR 
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LWC$ 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The L W C $ function returns a string formed by replacing all uppercase letters in the argument 
with lowercase letters. 



(lwc$) +(7)- 



string 
argument 



o 



Item 


Description 


Range 


string argument 


string expression 


— 



Examples 



DISP LWC*( "QWERTY" > 
IF LWC*<n*>="y" THEN 



G S U B Posi t i v e 



Description 

The LWC* function affects only the letters A through Z (characters with ASCII code 65 
through 90). 

Related Keywords 

UPC* 
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MASS STORAGE IS M 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The M fl S S S T R AGE I S statement designates the specified directory file as the current 
working directory. 



<! 



MASS STORAGE IS 



^tO 



file 
name 



HP-UX 
path name 



■©- 



string 
expression 



Item 


Description 


Range 


file name 


literal; name of a directory file in the current working 


14 characters 




directory 


maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name of a directory file 
(see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name of 
a directory file 


— 



Examples 



MASS STORAGE IS "textfiles" 

MASS STORAGE IS " ,-- vo 1 1 ,--d i r 2,--d i r 3 " 



Description 

The specified file must be a directory file. Once a directory file has been designated the cur- 
rent working directory, files in that directory can be accessed by file name alone. 
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M MAT 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The MAT statement performs a number of operations on arrays. The statement can be con- 
structed to perform arithmetic and scalar operations, matrix multiplication, and to initialize 
arrays to constant values. Through the use of secondary keywords, the statement performs a 
variety of special vector and matrix operations. 



Item 


Description 


Range 


array name 


name of a one- or two-dimensional numeric array 


any valid name 


vector name 


name of a one-dimensional array 


any valid name 


matrix name 


name of a two-dimensional array 


any valid name 


scalar operator 


operator used in scalar arithmetic with an array 


+ - * / 


arithmetic 


operator used in arithmetic operations involving two arrays 


+ - ■ / 


operator 






numeric 


(see glossary) 


— 


expression 






row # 


numeric expression, rounded to an integer 


valid row number 


col # 


numeric exression, rounded to an integer 


valid column 
number 



Ge> 



matr ix 
name 



-KE> 



»( idn y 



^D^ 



(h 



subscript 






O 



vector! fc /TN j 
name ^\Ls 



2-230 Keyword Dictionary 



...MAT 



M 



C^lMI 



rray 
ame 



-(E^-e 



array 
name 



sign change 



— */rsumV* 



-»^ con y 



k: 



-s>J 



o^ 



^-*»\ ' » ■ subscript — ' — *\) ) 



<^>((H^ 




*/TV-U numeric l^/TX 

^\jy expression | ^\J_J 



Linear 
equat ions 



Scalar 
operation 



Arithmet ic 
operation 



Matrix 

mult ipl icat ion 



Assignment 



G*D 
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M ...MAT 



Examples 



MAT 
MAT 
MRT 
MAT 
MAT 
MAT 
MAT 
MAT 

MAT 
MAT 
MAT 



N eg A r r a y = - P o sflrr a y 

a=-::eo 

R=CSUM< Array) 

A = S Y S < M atri x ., A r r a y 

fl=INV<M)*C 

Q = ( 2 t X > .•-' A r r a y 

Q = flrrayl . A r r a y 2 

B = ZER-::3,3> 



fl=flrray 
A<3 : 5, 2 



7 ) = A r r ay(l i 3 , 1 : 6 



U< 



: X o r = C R S S < '■.■' ect o r 1 .. V act o r 2 



Sign change. 

Arithmetic assignment. 

Sum of columns. 

System of linear equations. 

Inverse; matrix multiplication. 

Scalar operation. 

Arithmetic operation. 

Initializing (and redimensioning, if necessary) 
an array. 

Copying an entire array. 

Copying a portion of an array. 

Cross product. 



Description 

The MAT statement allows you to: 

■ Change the sign of every element in an array. 

■ Calculate the Inverse (IN 1 ... 1 ), and Transpose (TRN) of a matrix. 

■ Produce an identity matrix (I DM). 

■ Calculate the cross product (vector product) of two, 3 -element vectors (CROSS). 

■ Calculate the sum of the rows (RSUM) and the sum of the columns (CSUM) of an array. 

■ Solve a system of n linear equations with n unknowns (SYS). 

■ Assign the value 1 (COM) or zero (ZER) to all the elements of an array. 

■ Add, subtract, multiply, and divide a numeric expression and an array (scalar operation). 

■ Add, subtract, multiply, and divide the elements of two arrays (arithmetic operation). 

■ Perform matrix multiplication between two arrays. 

■ Copy all or a portion of an array into all or a portion of another array. 
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Identity (IDN). The secondary keyword I DM produces an identity matrix by assigning the 
value 1 to all diagonal elements (elements for which the row subscript equals the column 
subscript). If the matrix is not a square matrix before execution of the MAT = I DH statement, 
the matrix must be redimensioned within the statement by specifying redimension subscripts. 

Inverse (INV). The secondary keyword I N'., 1 calculates the inverse of a square matrix. (A ma- 
trix multiplied by its inverse produces an identity matrix.) When the determinant of a matrix 
equals 0, the inverse cannot be calculated. 

If the result matrix is not the same size and shape as the operand matrix, the system attempts 
to redimension it. An error is returned if the result array is not large enough to be properly 
redimensioned. 

Transpose (TRN). The secondary keyword TRH produces the transpose of a array by ex- 
changing the rows and columns of the operand array. The transpose of an n-by-m array is an 
m-by-n array; each element is defined by interchanging the subscripts. 

The result array must be dimensioned to be at least as large as the current size of the operand 
array. If necessary, the system redimensions the result array to the proper shape. 

Cross Product (CROSS). The secondary keyword CROSS calculates the cross product (vector 
product) of two, 3-element vectors. The two operand arrays and the result array must be 
vectors. 

Summing Rows and Columns (RSUM and CSUM). The secondary keyword RSUM com- 
putes the sum of each row of the operand array and assigns those values to the elements of a 
one -column vector. If the result array is a vector, it is redimensioned, if necessary, to have as 
many elements as the number of rows in the operand array. If the result array is a matrix, it is 
first redimensioned to have one column and as many rows as the operand array. 

The secondary keyword CSUM computes the sum of each column of the operand array and 
assigns those values to the elements of a one-row vector. As with RSUM, the result array is 
redimensioned, if necessary, to a vector of the proper size. 
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Solving the Matrix Equation AX=B. The secondary keyword SYS solves the matrix equa- 
tion AX=B for the unknown array X. This statement is most often used when solving a 
system of n linear equations in n unknowns: 



filial i CI12X2 ' ••• ' #in-^n — u\ 
Q,1\X\ + #22 -*2 ' •■■ 1 Q-2x\ X n = D<i 



a x\\ x \ + #n2 


X 2 + • 


• • ' ^nn -^n "n 




where 










a n 


a 12 ■ 


• «ln 




*1 




«21 


«22 • 


•• «2n 




*2 


A = 








,x = 






«nl 


«n2 • 


"nn 




X n 



andB = 



b 2 



A is the coefficient matrix, B is the constant array and X is the result array containing the 
solution to the system of equations. When B and X are matrices, SYS simultaneously solves 
two different systems of n equations in n unknowns. 

Assigning Values 1 and To Elements. The secondary keyword CON assigns the value 1 
to all elements of the result array. Optional parameters redimension the array to the specified 
size. 

The secondary keyword ZER assigns the value to all elements of the result array. As with 
CON, the optional parameters redimension the array to the specified size. 



2-234 Keyword Dictionary 



...MAT 



Scalar Operations. A scalar operation statement performs an arithmetic operation between a 
numeric expression and each element of the operand array. Array elements can be added to 
(+), subtracted from (-), multiplied by ($), and divided into (.-•) a specified numeric value. 

A scalar operation can also be used to change the sign of every element in an array. For 
example, 

MAT B = -H 

assigns values to the elements of array B by changing the sign of every element in array fl. 

Arithmetic Operations Between Arrays. An arithmetic operation statement performs addi- 
tion (+), subtraction (-), multiplication ( , ), or division (.••) between corresponding elements of 
two arrays. 

Matrix Multiplication. If A and B are the two operand arrays and C is the result array, 
matrix multiplication is defined by the equation: 

n 

Qj = A a ik bkj 
k= 1 

where n is the number of elements in a column in array A. 

Matrix multiplication follows these general rules: 

■ The result array has the same number of rows as the first operand array and the same 
number of columns as the second operand array. 

■ Matrix multiplication is legal only if the column size of the first operand array equals the 
row size of the second operand array. 

■ The system allows multiplication of a row vector and a column vector. However, two row 
vectors or two column vectors are not allowed. 

Arithmetic Assignment. An arithmetic assignment evaluates the numeric expression en- 
closed in parentheses and assigns that value to every element of the specified array. 



M 
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Copying Arrays. An array copy statement copies all or a portion of an operand array to all or 
a portion of a result array. 

The following rules apply to copying an entire array to another entire array: 

■ If both arrays are matrices, the result array is first redimensioned to have the same number 
of rows and columns as the operand matrix. 

■ If the result array is a vector, the operand array must be a vector, a one-column matrix, or a 
one-row matrix. The result vector is first redimensioned to have the same number of ele- 
ments as the operand array. 

■ If the result array is a matrix and the operand array is a vector, the result matrix is first 
redimensioned to have one column and as many rows as the number of elements in the 
operand vector. 

The following rules apply to copying values from and/or into a portion of an array (subarray): 

■ If all elements of the operand array are to be copied, do not specify row or column numbers 
after the operand array name. If all elements of the result array are to be assigned values, 
do not specify the row or column numbers after the result array name. The values of array 
elements are transferred in order from left to right along each row, and from top row to 
bottom row. 

■ If no row or column numbers are specified after the result array, the result array is 
redimensioned before the values are assigned. If row or column numbers are specified after 
the result array, values are assigned to the specified elements, but no redimensioning 
occurs. 

■ If an array is a vector, specify only the row number. 

■ If an entire row is to be copied or assigned values, the column numbers may be omitted; 
however, a comma must be placed after the row number. If an entire column is to be copied 
or assigned values, the row numbers may be omitted; however, a comma must be placed 
before the column number. For example, M R T B < , 4 > = M fl T R copies all the elements in 
vector A into column 4 of array B. 
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■ If only one row or column is to be copied, specify the row or column number. If more than 
one row or column are copied, specify the beginning and ending row or column number, 
separated by a colon. For example, MAT B<3, 1 : 4 ;■ = M Fi T FK2 : 5 .. 2> copies elements 
from column 2, rows 2 through 5 of array A into row three, columns 1 through 4 of array 
B. 

■ If the operand and result arrays are both matrices, the number of rows (and columns) speci- 
fied after the result array must equal the number of rows (and columns) copied from the 
operand array. 

A column from an operand matrix cannot be copied into a row of a result array using one 
statement. Conversely, a row from an operand matrix cannot be copied into a column of the 
result arrary using one statement. In both cases, values must first be copied to an intermediate 
vector. 

Related Keywords 

REDIM 
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M MAT DISP 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The MAT DISP statement displays the specified array (s). 



(mat disp} - 



Mj 



USING, 





IMAGE line 




, ( 




number 


, 


i *\ 






IMAGE line 
label 




















format 
str ing 








* 










> » . terminator 



Item 


Description 


Range 


array name 


name of a numeric array 


any valid variable 
name 


IMRGE line 
number 


integer constant identifying an IMAGE statement 


1 through 65,535 


IMRGE line label 


name identifying an IMAGE statement 


any valid line 
name 


format string 


string expression consisting of one or more field specifiers 
(see I M A G E statement for syntax) 


— 


terminator 


comma, semicolon, or slash 


— 



Examples 



MAT DI 
MAT DI 
MAT DI 



P A 

P RON A$.; COL &/ 

P USING 200: COL fir rani 
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...MAT DISP M 



Description 

MAT DISP provides two forms of output: simple (without USING) and formatted (with 
USING). 

The optional keywords RON and COL specify the arrangement of the displayed array elements. 
Specifying RON causes elements to be displayed by rows. Each row begins on a new line, and 
the elements in each row are displayed in order from the first column to the last column. 
Specifying COL causes elements to be displayed by columns. Each column begins on a new 
line, and the elements of a column are displayed in order from the top row to the bottom. The 
default arrangement is RON. More than one line may be required to display a row or column. 

Simple MAT DISP (without USING). A terminator is placed after the array name to specify 
the horizontal spacing between elements. A final terminator after the last array name in the 
statement specifies spacing for that array. Unlike the D I S P statement, the end-of -line se- 
quence is not suppressed. 

MAT DISP Terminators 



Terminator 



Spacing Between Elements 



Close spacing; elements are separated by two spaces. A minus sign occupies one 
space. 

Wide spacing; elements are left-justified in 21 -column fields. 

One element per line. 
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M ...MAT DISP 



Formatted MAT DISP (with USING). MAT DISP USING uses a format string contained in 
the statement itself, or in a referenced IMAGE statement, to define the format of the output. 
The format string, consisting of one or more field specifiers separated by delimiters, is used 
from left to right. Elements are paired with their corresponding field specifiers. If the format 
string is exhausted before all the display items have been processed, the format string is re- 
used from the beginning. Extra field specifiers are ignored. If a field is larger than a number, 
the number is right-justified in the field. A warning is issued if an element is larger than the 
field. Numbers are rounded to the number of decimal places indicated by the field specifier. 

The comma, semicolon, and slash terminators can be used interchangeably. Spacing is con- 
trolled entirely by the format string. A final terminator does not suppress the end-of-line 
sequence. 

Refer to IMAGE for the syntax of the format string. 

Related Keywords 

IMAGE, MAT PRINT 
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MAT INPUT M 



Keyboard Executable 
Programmable 

In an IF...THEN 



□ 



The MAT INPUT statement inputs values into the specified array (s). 



MAT INPUT 



> 



o-, 



J array 



Item 


Description 


Range 


array name 


name of a numeric array 


any valid variable 
name 



Examples 



MAT INPUT B 

MAT INPUT Numer icArray 



S t r i rig Array 



Description 

When MAT I N P U T is executed, the program prompts for elements of the first specified array 
by displaying the variable name of the first element — for example, A r r a y (. , > . One or 
more values, separated by commas, can be entered at a time. Values are assigned to array 
elements from left to right along a row, from top row to bottom. When one or more values 
have been entered, MAT INPUT prompts for the next element to be assigned. Input into the 
array continues until all the elements have been assigned values. If an array becomes full in 
the middle of an input line, the remaining elements on the line are ignored. 
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M ...MAT INPUT 



If a second array is specified, input into it starts at the next input line after the first array is 
full. 

Input continues until all the specified arrays are full. 

Related Keywords 

MAT READ 
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MAT PRINT 



M 



Keyboard Executable 
Programmable 

In an IF...THEH 

The MAT PRINT statement outputs the specified array(s) to the PRINTER IS device. 



MAT PRINT 



> 





IMAGE line 




,( 




number 


, 


i *\ 






IMAGE line 
label 






j 














format 
string 


















Item 


Description 


Range 


array name 


name of a numeric array 


any valid variable 
name 


IMAGE line 


integer constant identifying an I M fl G E statement 


1 through 65,535 


number 






IMAGE line label 


name identifying an I M A G E statement 


any valid line 
name 


format string 


string expression consisting of one or more field specifiers 
(see I M fl G E statement for syntax) 


— 


terminator 


comma, semicolon, or slash 


— 



Examples 



MAT PRINT fl 

MAT PRINT ROW A.: COL &/ 

MAT PRINT USING 280: COL Array! 
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M ...MAT PRINT 



Description 

MAT PRINT provides two forms of output: simple (without USING) and formatted (with 
USING). 

The optional keywords ROW and COL specify the arrangement of the printed array elements. 
Specifying ROW causes elements to be printed by rows. Each row begins on a new line, and 
the elements in each row are printed in order from the first column to the last column. Speci- 
fying CGL causes elements to be printed by columns. Each column begins on a new line, and 
the elements of a column are printed in order from the top row to the bottom. The default 
arrangement is ROW. More than one line may be required to print a row or column. 

Simple MAT PRINT (without USING). A terminator is placed after the array name to specify 
the horizontal spacing between elements. A final terminator after the last array name in the 
MAT PRINT list specifies spacing for that array. Unlike the P R I N T statement, the end-of-line 
sequence is not suppressed. 

MAT PRINT Terminators 



Terminator 


Spacing Between Elements 


.; 


Close spacing; elements are separated by two spaces. A minus sign occupies one 




space. 


.■ 


Wide spacing; elements are left-justified in 21 -column fields. 




One element per line. 



Formatted MAT PRINT (with USING). MAT PR I NT US I NG uses a format string contained 
in the statement itself, or in a referenced I M fl G E statement, to define the format of the output. 
The format string, consisting of one or more field specifiers separated by delimiters, is used 
from left to right. Elements are paired with their corresponding field specifiers. If the format 
string is exhausted before all the print items have been processed, the format string is reused 
from the beginning. Extra field specifiers are ignored. If a field is larger than a number, the 
number is right-justified in the field. A warning is issued if an element is larger than the field. 
Numbers are rounded to the number of decimal places indicated by the field specifier. 
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...MAT PRINT M 



The comma, semicolon, and slash terminators can be used interchangeably. Spacing is con- 
trolled entirely by the format string. A final terminator has no effect on the output. 

Refer to IMAGE for the syntax of the format string. 

Related Keywords 

DISP, IMAGE, MAT DISP 
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M MAT READ 



Keyboard Executable D 
Programmable ■ 

In an IF... THEN ■ 

The MFiT READ statement reads values from DflTR statements and assigns them to array 
elements. 



rO-\ 



(mat read^- 



array 
name 



Item 


Description 


Range 


array name 


name of a numeric array 


any valid name 



Examples 

MAT R E fl D N u m ericflr r a y 
MAT READ fl, B 

Description 

The values are read from DflTfl statements and assigned to array elements from left to right 
along a row, from top row to bottom. Arrays are filled in the order in which they are listed. If 
there are not enough data elements to satisfy MAT READ, the program returns an error and 
program execution halts. 

Related Keywords 

MAT INPUT 
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MAX 



M 



The MAX function compares two numeric arguments and returns the larger of the two values. 



C MAX ) *\SJ * Bourne nt 1 *\y » a^uTen't | *\L/ *" 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 



Y=MHX< 10, X) 

C o u nter = I P '■ M fl K < I , J > > 

Related Keywords 

M I N 
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M MAXAB 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The MflKflB function computes the absolute value of each element in the specified array and 
returns the largest value. 



(maxab) — **(J)- 



array 
name 



<>> 



Item 


Description 


Range 


array name 


name of a one- or two-dimensional numeric array 


any valid name 



Examples 

DISP MRXREKRrr ay 1 > 

IF MHXflB<flrrayl >=1 THEN 599 

Related Keywords 

rmrx, rmrxcol, nnnxRow, mrxrbcol, mrxrbrou 
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MAXABCOL M 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The M fl X fl B C L function returns the column number of the element whose absolute value was 
returned by the most recently executed MflXfiB function. 



(maxabcol) — »- 

Examples 

Y S u bsript= M fl X fi B C L 
fl >: 3 , M fl X R B C L ;■ = 1 2 

Description 

If two or more elements in different columns have the largest absolute value, the lowest col- 
umn number is returned. 

Related Keywords 

fl MAX COL, MflXflB, MflXflBROW 
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M MAXABROW 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The MRXfiBRuW function returns the row number of the element whose absolute value was 
returned by the most recently executed MAX FIB function. 



(maxabrow) — *■ 



Examples 

XSubscr ipt=|-1fiXfiBRCiW 

M Fi T C = R r r a y 2 ■:'. 1 : M R X fl B R W , 4 ) 

Description 

If two or more elements in different rows have the largest absolute value, the lowest row 
number is returned. 

Related Keywords 

RMRXCOL, MRXRB, MRXflBCOL 
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MDY M 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The MDY function converts a string expression in the form MM/DD/YYYY to the equivalent 
Julian Day number. 



(^y-^Q- 



string 
argument 



o-~ 



Item 


Description 


Range 


string argument 


string expression in the form "MM/DD/YYYY" 


"10/15/1582" 

through 

"11/25/4046" 



Examples 

DISP MDY '::"04.--20,- 1984" > -MDY < " 1 0..-0 3..' 1 983 " > 
IF MDY<Day*><2446160 THEN 2099 

Description 

The allowable parameters correspond to Julian Day numbers 2,299,161 through 3,199,160. 

Related Keywords 

DATE, DATE*, MDY* 
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M MDY$ 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The MDY* function interprets a numeric expression as the Julian Day number and converts it 
to a string expression in the form MM/DD/YYYY. 



(W)~<(>- 4" JU n^Ce^ y K T)-» 



Item 


Description 


Range 


Julian Day 
number 


numeric expression, rounded to an integer, interpreted as the 
Julian Day number 


2,299,161 

through 

3,199,160 



Examples 

D I S P M D Y $ < 3 ':> 
Day* = MDY*O0 

Description 

The allowable parameters correspond to October 15, 1582 through November 25, 4046. 

Related Keywords 

DATE, DATE*, MDY 
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MERGE M 



Keyboard Executable ■ 
Programmable □ 

In an IF...THEN □ 

The MERGE command merges a program or subprogram retrieved from mass storage with the 
current program or subprogram in system memory. 



(merge)- 



O 



file 
name 



HP-UX 
path name 



J 



Of 



string 
expression 



beginning line number 
of merged lines 



^"0~~*t™i 



icrement of 
;rged lines 



Item 


Description 


Range 


file name 

HP-UX path name 

string expression 

beginning line 
number of merged 
lines 

increment of 
merged lines 


literal; name of a BASIC/PROG or BASIC/SUBP file 

literal; an absolute or relative path name (see glossary) 

expression evaluating to a file name or HP-UX path name 

integer constant identifying a program line (default=last line 
number of current program + 1 0) 

integer constant (default=10) 


14 characters 
maximum; slash 
and leading colon 
not allowed 

1 through 65,535 
1 through 65,535 



Examples 

MERGE "Traffic" 
MERGE "ER"20Q.5 
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Description 

If the file name is used alone (rather than as part of an HP-UX path name), the MERGE 
operation uses the current working directory. The current working directory is selected by the 
MASS STORAGE IS statement. 

MERGE retrieves the specified BASIC/PROG or BASIC/SUBP file from mass storage, renum- 
bers the retrieved program lines, and adds them to the current (sub)program in system 
memory. The merged program is renumbered according to the beginning line number of 
merged lines and the increment of merged lines specified in the MERGE command. If the 
optional parameters are omitted, the beginning line number of merged lines is obtained by 
incrementing the last line number in system memory by 10. 

When programs are merged using the optional parameters, any merged lines renumbered to 
the same line numbers as lines currently in memory overwrite those lines. 

The message . . .end o f m erge is displayed at the conclusion of the merge operation. 

Related Keywords 

FINDPROG, REN 
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MIN M 



The M I N function compares two numeric arguments and returns the smaller of the two values. 



(™j>-<i> 



numeric 
argument 



^^ \ ^1 numeric I ^/ T^ 
^J_J I argument | \J_J 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 



Y = MIH< IB, tt :■ 

C o u nter = I P < M I N (. I , J > ') 

Related Keywords 

MAX 
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M MOD 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The MOD operator returns the remainder resulting from a division operation. 



-» ^mod ) — *■ d 



Item 


Description 


Range 


dividend 
divisor 


numeric expression 
numeric expression 


— 



Examples 

C=3 MOD 3 

IF Hours MOD Trip<3 THEM 308 

Description 

The MOD operation is denned by the equation: 

A MOD B = A - B * INT(A/B) 

where INT(A/B) is the greatest integer less than or equal to A/B. By definition, A MOD 
is A. 

Related Keywords 

D I U 
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MOVE M 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The MOVE statement lifts the pen and moves it to the specified x-, y-coordinate position. The 
pen remains up until it is lowered by another statement. 



f MOVE ) ^ x-coordinate *{ J ^ y-coordinate »■ 



Item 


Description 


Range 


x-coordinate 
y-coordinate 


numeric expression, interpreted in the current units 
numeric expression, interpreted in the current units 


— 



Examples 



MOVE 10, 10 

MOVE ttPosi t ion, KPosi t ion^S 

Description 

MOVE uses the current units mode (UU's or GU's). The physical pen cannot move beyond the 
plotting boundaries (equivalent to the graphics limits in GU's mode). However, the logical pen 
can be moved beyond the plotting boundaries or graphics limits. 

Related Keywords 

I MOVE, PLOT 
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M MSCALE 



Keyboard Executable 
Programmable 

In an IF...THEH 



The M SCALE statement specifies millimeter user units scaling of the plotting area and the 
location of the origin. 



( MSCALE y 



x-of f set 



o 



y-of f set 



Item 


Description 


Range 


x-offset 
y-offset 


numeric expression, interpreted as millimeters 
numeric expression, interpreted as millimeters 


— 



Examples 

MSCALE 10,5 
M S C A L E A * 1 9 , A 



Description 

The MSCALE parameters specify, in millimeters, the offset of the origin from the lower-left 
corner of the plotting area. MSCALE scales the current plotting area, which is a function of the 
units mode (GU's or UU's) and the previously executed statements. 

■ In GU's mode, MSCALE scales the entire graphics area previously specified by 
PLOTTER IS or LIMIT). 

■ In UU's mode, M S C A L E scales the plotting area previously specified by L C A T E . If L C A T E 
has not been executed, the entire graphics area is scaled. 

After executing MSCALE, the system in set to UU's mode. 



Related Keywords 



LIMIT, LOCATE, PLOTTER IS, SCALE, SHOW 
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NEXT 



See FOR...NEXT. 



N 



(n!xt> 



loop 
counter 
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NORMAL 



Keyboard Executable 
N Programmable 
In an IF...THEN 



The HORMhL statement cancels print-all mode and program tracing (TRACE, TRACE VAR, 
and TRACE ALL) operations. 



( NORMAL ) »- 

Related Keywords 

RUTO, PRIHTfiLL, TRRCE 
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NOT 



Keyboard Executable ■ 
Programmable ■ N 

In an IF...THEN ■ 



The HOT operator returns 1 if its operand equals 0. Otherwise, is returned. 



-» ( not) - 



operand 



Description 

A non-zero expression (positive or negative) is interpreted as a logical 1; a zero is interpreted 
as a logical 0. The following table describes the results of performing a NOT operation. 

Logical NOT 



A 


NOT A 



non-zero 


1 




Related Keywords 



AND, EX OR, OR 



Keyword Dictionary 2-261 



NPAR 



Keyboard Executable ■ 
N Programmable ■ 

In an IF. ..THEN ■ 

The HPflR function returns the number of parameters passed to a subprogram by a CALL 
statement. 



Examples 



N N P fl R G T 2 , 3 ., 4 
IF NPflR=2 THEN SUBEXIT 

Related Keywords 

CALL, SUB 
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NUM 



Keyboard Executable ■ 
Programmable ■ N 

In an IF. ..THEN ■ 

The HUM numeric function returns the decimal value of the first character in the string 
argument. 



G^y-*(J> 



string 
argument 



O 



Item 


Description 


Range 


string argument 


string expression 


— 



Examples 

X=NUM<Str ing*Cfl,Fm 

IF NUM'::fl$>=32 THEN Skip 

Description 

The value returned is in the range through 255. When the argument is the null string, NUM 
returns 0. 



Related Keywords 

CHR* 
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OFF CURSOR 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The OFF CURSOR* statement removes the cursor from the alpha display. The cursor position 
remains unchanged. 

O 



OFF CURSOR 



> 



Related Keywords 

OH CURSOR 



: Implementation of OFF CURSOR is machine-dependent. 
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OFF EOT 



Keyboard Executable 
Programmable 

In an IF...THEN 



The OFF E T statement disables end-of-line branching for termination of a T R fl H S F E R oper- 
ation on the specified interface. 



(off eot)- 



interf ace 
select code 



Item 


Description 


Range 


interface select 
code 


numeric expression, rounded to an integer 


3 through 10 



Examples 

OFF EOT 7 
OFF EOT Isc 

Description 

When a transfer terminates after OFF EOT has been executed, the system retains a pending 
end-of-line branch. The branch is taken immediately when H E T is executed for that inter- 
face. Only one (the most recent) end-of-line branch can be pending. 

Related Keywords 

ON EOT, TRANSFER 
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OFF ERROR 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The OFF ERROR statement cancels event-initiated branching previously enabled by a 
OH ERROR statement. Further errors halt program execution. 

O 



( OFF ERROR ) *- 

Related Keywords 

OH ERROR 
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OFF INTR 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The OFF I H T R statement cancels end-of-line branching for interface interrupts previously es- 
tablished by OH INTR. 



(offIntr) — » Ui^o e d 



Item 


Description 


Range 


interface select 
code 


numeric expression, rounded to an integer 


3 through 10 



Examples 

OFF INTR 7 
OFF INTR Isc 



Description 

If the interface is enabled for interrupts (by ENABLE INTR), OFF INTR prevents branching 
when an interrupt occurs. However, the interrupt is retained by the system; the branch will be 
taken immediately if N INTR is executed. If more than one interrupt occurs, only the last 
one is retained. 

Related Keywords 

CONTROL, ENABLE INTR, OH INTR 
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OFF KEY# 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The OFF KEY# statement cancels end-of-line branching previously enabled by an ON KEY# 
statement. 



(off key»)- 



U 



key number 



n 



Item 


Description 


Range 


key number 


numeric expression, rounded to an integer 


must correspond 
to a special func- 
tion key 



Examples 

OFF KEY# 1 
OFF KEY* N 



Description 

If the key number is omitted, all current run-time OH KEY* assignments are canceled. 

Related Keywords 

ON KEY* 
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OFF KYBD 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The OFF KYBD statement cancels end-of-line branching previously enabled by an ON KYBD 
statement. 



(OFF KYBD^ A strin ? 

V" ' "y n expression 



Item 


Description 


Range 


string expression 


characters and/or escape sequences representing the keys 
for which branching is disabled. 


— 



Examples 



OFF KYBD "1234567390" 
OFF KYBD fi* & "#*" 

Description 

When the optional parameter is omitted, OFF KYBD cancels branching for all previously en- 
abled keys. 

Related Keywords 

OFF KEY#, OH KYBD 
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OFF TIMEOUT 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The OFF T I M E U T statement cancels end-of-line branching for timeouts on the specified 
interface. 



(OFF TIMEOUT) * \ s ^^ f 



race 
code 



Item 


Description 


Range 


interface select 
code 


numeric expression, rounded to an integer 


3 through 10 



Examples 

OFF TIMEOUT 7 
OFF TIMEOUT I 



Description 

When a timeout (specified by S E T T I M E U T) occurs after OFF T I M E ij T has been executed, 
the system retains a pending end-of-line branch. The branch is taken immediately when 
ON TIMEOUT is executed for that interface. 



Related Keywords 

OH TIMEOUT 
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OFF TIMER# 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The OFF T I M E R # statement cancels end-of-line branching for the specified timer. 



( OFF TIMER* y 



timer number 



Item 


Description 


Range 


timer number 


numeric expression, rounded to an integer 


1 through 3 



Examples 



OFF TIMERtt 3 

OFF TIMER* T i m e r H u m b e r 

Related Keywords 

OH TIMERtt 
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ON 



Keyboard Executable □ 
Programmable ■ 

In an IF... THEN ■ 

The ON... GO TO/GO SUB statements transfer program execution to one of the specified program 
lines based on the value of a pointer. 



(ON J— »> pointer i »/gOTcA 



O 



-T-^ V 3 " 1 "^ i ' I - |number| T 



Item 


Description 


Range 


pointer 

line number 
line label 


numeric expression, rounded to an integer 

integer constant identifying a program line 
name of a program line 


(see 
Description) 

1 through 65,535 

any valid name 



Examples 



2 5 @ N P < 1 > G T 2 @ @ , 4 @ , 64 @ 

740 OH . 5*Po i n terl GOSUB Subr ou t i ne 1 , Subr ou tin* 

612 IF Y THEN ON Y GOTO 33@, Odd. 788 
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...ON 



Description 

When the pointer evaluates to 1, execution is transferred to the first line number or line label. 
When the pointer evaluates to 2, execution is transferred to the second line number/label, and 
so on. An error is returned if the pointer evaluates to a number less than 1 or greater than the 
number of line numbers/labels. In practice, the maximum value of the pointer equals the 
number of line numbers/labels that can be typed into a program line. 

If the GOSUB keyword is used, execution is tranferred to the specified subroutine. When the 
subroutine RETURN statement is executed, execution branches to the statement immediately 
following H . . . G S U B . 

Related Keywords 

GOSUB, GOTO, RETURN 
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ON CURSOR 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The ON CURSOR* statement displays the cursor after it has been previously turned off by the 
OFF CURSOR statement. 

O 



( ON CURSOR y 



Related Keywords 

F F C U R S R 



Implementation of ON CURSOR is machine-dependent. 
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ON EOT 



Keyboard Executable □ 
Programmable ■ 

In an IF...THEN ■ 



The OH EOT statement defines and enables end-of-line branching when the last byte of data 
is transferred by a TRANSFER statement. 



( ON EOT y 



inter f ace 
select code 



m 



SOTOJ I ■ H numSerf — p" 



Item 


Description 


Range 


interface select 
code 

line number 

line label 


numeric expression, rounded to an integer 

integer constant 

name of a program line 


3 through 10 

1 through 65,535 
any valid name 



Examples 

H EOT 7 G T 1 S 

ON EOT Isc GOSUB Transfer Done 

Description 

When ON EOT is executed, any pending end-of-line branch for a previous, unserviced trans- 
fer termination at the specified interface is taken immediately. 

ON EOT overrides any previous ON EOT for that interface. 

Related Keywords 

OFF EOT, TRANSFER 
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ON ERROR 



Keyboard Executable □ 
Programmable ■ 

In an IF. ..THEN ■ 

The OH ERROR statement defines and enables an event-initiated branch to be taken when a 
run-time error occurs. 



(on error)- t -i*(goto)- 



U(i 



GOTO)— I— I HnumSerl — T 

60SUJ)-J ^~ H iV^l H 



Item 


Description 


Range 


line number 
line label 


integer constant identifying a program line 
name of a program line 


1 through 65,535 
any valid name 



Examples 



OH ERROR GO SUB 100 

H E R R R G T R e c o v e r m 
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...ON ERROR 



Description 

ON ERROR branching occurs immediately when a run-time error is detected, and has higher 
priority than any other event-initiated routine. When an ON ERROR. ..GOSUB statement is 
used, the recovery routine RET U R H statement returns execution to the program line following 
the one that generated the error. If an error occurs in the middle of a multistatement line, the 
O rest of the line is not executed. 

The ON ERROR declaration remains active during the recovery routine unless it is disabled by 
executing OFF ERROR. In general, OFF ERROR should be executed at the beginning of the 
recovery routine to prevent an infinite loop between the line containing the error and the 
beginning of the recovery routine. 

ON ERROR declarations take precedence over all other program interrupts. (Refer to the 
Branch Precedence Table on page 4-13.) 

ON ERROR declarations are local to the program or subprogram in which they are executed. 

Related Keywords 

OFF ERROR 
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ON INTR 



Keyboard Executable □ 
Programmable ■ 

In an IF...THEH ■ 

The H I N T R statement defines an end-of-line branch to be taken when an interface gener- 
ates an interrupt. 



(onintb) — « {.;;;;;';sg. | — p»<W) . , »|S 



Wi 



, bulu J i I H numberj I 



Item 


Description 


Range 


interface select 
code 

line number 

line label 


numeric expresion, rounded to an integer 

an integer constant specifying a valid line number 
name identifying a program line 


3 through 10 

1 through 65,535 

any valid line 
name 



Examples 

ON INTR 
ON INTR 



G T 3 S 



JB 



'< & r v ice 
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...ON INTR 



Description 

OH INTR establishes the end-of-line branch to be taken when an interface interrupt occurs. 
Interrupt causes are specified by setting the appropriate bit(s) in Control Register 1 using the 
ENABLE I N T R or C N T R L statement. 

q When an interrupt occurs and is serviced, end-of-line branching is disabled for the interface 
until enabled using ENABLE INTR or CONTROL. It is not necessary to execute ON INTR 
again. 

If a pending end-of-line branch from a previous, unserviced interrupt exists when N I H T R is 
executed, the branch is taken immediately. Only one interrupt per select code is retained by 
the system. 

Executing a second ON INTR statement for the same interface overrides the previous 
ON INTR. If two interfaces interrupt during the same line, the order in which the interrupts 
are serviced is determined by their precedence. (Refer to the Branch Precedence Table, page 4- 
13, for additional information.) 

Related Keywords 

CONTROL, ENABLE INTR, OFF INTR 
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ON KEY# 



Keyboard Executable 
Programmable 

In an IF...THEN 

The ON KEY# statement defines the functions of the user-defined (special function) keys. 



(on key*)— » 



key number 



■(goto) 



I m /T\ fc ^\ J key I fc /^T\ J 

I fc/O >/^ J ke y 



w(g 



60SUB 



line number 




line label 



typing 1 ^/ ^u\ 

_aid__|— *\^r 



Item 


Description 


Range 


key number 


numeric expression, rounded to an integer 


must correspond 
to the number of 
one of the special 
function key 


key label 


literal or string expression evaluating to displayable charac- 


1 through 8 




ters 


characters 


line number 


integer constant identifying a program line 


1 through 65,535 


line label 


name of a program line 


any valid name 


typing aid 


literal composed of displayable characters and/or control 


1 through 32 




characters 


characters 



Examples 



OH KEY# 3, "BREAK" GOSUB Break 

OH KEV# 4 , " Pa t h " , " d i r 1 ,--d i r 2,-d i r 3 " 
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■■■ON KEY# 

Description 

The syntax and function of OH KEY# has two forms: 

■ When ON KEY# is executed within a program, it defines and enables a branch to be taken 
when the specified user-defined key is pressed. The optional key label parameter provides 
for displaying a key label when KEY LABEL is executed in the program. 

■ When ON KEY# is executed from the keyboard, it defines a typing aid for a sequence of 
characters. Typing aids are in effect whenever a program is not running. The optional key 
label parameter provides for displaying a key label. 

If the the typing aid string consists of a keyboard executable statement or command fol- 
lowed by a carriage return, pressing the key executes the statement or command 
immediately. 

When N K E Y # is executed within a program, end-of-line branching is enabled for the speci- 
fied key. If the ON KEY#...GOSUB statement is used, the subroutine RETURN statement causes 
branching to the statement following the one being executed when the key was pressed. 

ON KEY# end-of-line branching is disabled by executing OFF KEY#. 

Refer to the Branch Precedence Table on page 4-13 for additional information. 

Related Keywords 

ENABLE KBD, KEY LABEL, OFF KEY# 
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ON KYBD 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The OH KYBD statement defines and enables an event-initiated branch to be taken when the 
specified key(s) is(are) pressed during program execution. 



(onkybd) -4T 



jmenc 
lame 



k>H 



string 
expression 



u 



-» (goto) 



gosub) — ' 



1 ine 
number 



1 ine 
label 



Item 


Description 


Range 


numeric name 


name of a simple numeric variable or numeric array element. 


— 


string expression 


characters and/or escape sequences representing the keys 
for which branching is enabled 


— 


line number 


integer constant identifying a program line 


1 through 65,535 


line label 


name of a program line 


any valid name 



Examples 



ON KYBD Keys, " 1234567890" GOSUB Number k ey: 
ON KYBD Hl,CHR$':: 27 >&:"w" GOTO 130 
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...ON KYBD 



Description 

Executing OH KEYBD enables end-of-line branching to the specified program line when any 
of the keys listed in the string expression are pressed. Alphanumeric keys are identified in the 
string expression by their displayable character (for example, a and R for the unshifted and 
shifted (X) key) or by their numeric key code (for example, CHR$ < 65 > for ®). Keys without 
displayable characters (special keys, such as tab, cursor control, and special function keys) must 
be identified by their escape sequences.* For example, the following statement enables 
ON KYBD branching for (t) and £<), assuming ESC D for the (2D key: 

ON KYBD Keyvar , "fl"8.CHR*<27>S<"D" GOTO 100 

When a keystroke triggers an interrupt that causes branching to the specified program line, the 
key code of the key pressed is assigned to the numeric variable. That variable assignment 
remains in effect until the variable is reassigned by an assignment statement or by pressing 
another key specified in the ON KYBD statement. For example, pressing ® assigns the value 
65 to variable Keyvar. 

The most recent ON KYBD declaration overrides any previous ON KYBD statement. Keys en- 
abled in the previous statement remain active; however, branching will occur to the most 
recently specified program line, and the variable assignment will be made to the most recently 
specified variable. 

When the optional string expression is omitted, branching remains in effect for all previously 
specified keys. 

When ON KYBD branching is enabled for any of the special function keys, it overrides 
ON KEY# branching previously specified for those keys. ON KYBD declarations are local to 
the program or subprogram in which they are enabled. 

One or more enabled keys can be disabled by executing OFF KYBD. 

Related Keywords 

OFF KYBD, ON KEY# 



* Escape sequences are machine dependent. 
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ON TIMEOUT 



Keyboard Executable D 
Programmable ■ 

In an IF. ..THEN ■ 

The H TIME U T statement enables end-of-line branching when an interface timeout occurs 
on the specified interface. 



( 



ON TIMEOUT 



> 



interface 
select code 



-•/goto)- 



SOTO) I | H nu^enh -p- 
G°SUB)-J H 1 ■ alfl h ^ 



Item 


Description 


Range 


interface select 
code 

line number 

line label 


numeric expression, rounded to an integer 

integer constant 
name of a program line 


3 through 10 

1 through 65,535 
any valid name 



Examples 



OH TIMEOUT 7 GOTO 300 

OH TIMEOUT Isc GO SUB Recover 
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...ON TIMEOUT 



Description 

The amount of time the system will wait for completion of a handshake is set by 

SET T I M E U T . If H TIME U T is executed after the SET TIMEOUT limit has been exceeded 

for that interface, the end-of-line branch is taken immediately. 

q A timeout will not occur when a peripheral device stops handshaking in the middle of a 
transfer operation (TRANSFER IHTR or TRANSFER FHS). However, a transfer can timeout if 
the interface or device cannot be addressed to start the transfer. 

ON TIMEOUT overrides any previous ON TIMEOUT for the specified interface. 

Related Keywords 

OFF TIMEOUT, SET TIMEOUT 



2-286 Keyword Dictionary 



ON TIMER# 



Keyboard Executable D 
Programmable ■ 

In an IF. ..THEN ■ 

The N T I M E R # statement defines an end-of-line branch to be taken when the specified time 
interval has elapsed. 



C 



ON TIMER# 



timer 
number 



o 



mill iseconds 



■{goto} 



U<o 



60SUB 



line 
number! T 



line 
label 



Item 


Description 


Range 


timer number 
milliseconds 
line number 
line label 


numeric expression, rounded to an integer 
numeric expression 

integer constant identifying a program line 
name of a program line 


1 through 3 

1 through 65,535 
any valid name 



Examples 



OH TIMERtt 2, 5S8S UOTG Service 

H TIMERtt T N u m b e r , T L i m i t G S U B 1 U @ 
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...ON TIMER# 



Description 

When H T I M E R # is executed, the specified timer is set to zero and activated. When the 
milliseconds interval has elapsed, the branch is taken at the end of the current program line. 
After the branch has been taken, the timer is reset to zero and immediately reactivated. If the 
ON TIMER#...GOSUB statement is used, the subroutine RETURN statement causes branching 
to the statement following the one being executed when the key was pressed. 

OH TIMER* branching remains in effect until an OFF T I MER# statement is executed for that 
timer, or until the program chains another program into memory. Timers continue to come 
due when the program is paused or delayed (by a WRIT statement), but the branch is not 
immediately taken. Pending branches are taken when the program is continued or when the 
N fl I T interval has elapsed. 

Related Keywords 

OFF TIMER* 
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OPTION BASE 



Keyboard Executable □ 

Programmable ■ 

In an IF...THEN □ 

The P T 1 N E fl S E statement specifies the lower bound of all arrays in a program. 



(option base) — + \l° " e n 



Item 


Description 


Range 


lower bound 


integer constant (default =0) 


or 1 



Examples 

OPTION BASE 1 

Description 

An P T 1 H B fl S E statement can occur only once in a program, and must precede any ex- 
plicit variable declarations. The option base is the lower bound of all numeric and string 
arrays in the program. (Upper bounds are declared in the dimensioning statements — REAL, 
SHORT, INTEGER, and DIM.) 

The option base declaration is global; the option base is passed to any subprograms called by 
the program. An error may result if a subprogram attempts to specify another option base. 

When a program chains another program, the option base of the two programs must agree. 

Related Keywords 

DIM, INTEGER, REAL, SHORT 
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OR 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The OR operator returns a 1 or based on the logical inclusive-OR of the operands. 



operand 



<Z> 



operand 



Item 


Description 


Range 


operand 


numeric expression 


— 



Examples 

IF fl OR B THEN C 
D e c i s i o n = Y e s R N o 



Description 

A non-zero operand (positive or negative) is interpreted as a logical 1; an operand of zero is 
interpreted as a logical 0. The following table describes the result of performing a logical OR. 



Inclusive OR 


A 


B 


A OR B 














1 


1 


1 





1 


1 


1 


1 



Related Keywords 

AND, EX OR, NOT 
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OTD 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN I 

The OTD (octal-to-decimal) function interprets the string argument as the octal (base 8) repre- 
sentation of an integer and returns the numeric decimal equivalent. 



(~™)-+<j)—* \ an^en 9 t h ~ K7)— ' » 



Item 


Description 


Range 


string argument 


string expression containing the base 8 representation of an 
integer 


characters must 
be through 7; 
cannot exceed the 
range of integers 



Examples 

U = T D < "3567" > 

IF I=OTD<H*> THEN 45 

Related Keywords 

BTD, DTBt, DTH*, DTO*, HTD 
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OUTPUT 



Keyboard Executable 
Programmable 

In an IF—THEN 



The OUTPUT statement outputs items to the specified destination. 



dest inat ion 



C output y 



1/0 buffer 
name 



O^ 



^■(using) 



device 
selecton 




k _ f u\ fc format 
^ I stnini 



O 



o 




numeric 
expression 



string 
expression 




output items 



KlH 



trailing punctuation 
ignored with USING 
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...OUTPUT 



Item 


Description 


Range 


device selector 


numeric expression, rounded to an integer (see glossary) 


— 


I/O buffer name 


name of a string variable declared as an I/O buffer 


— 


IMAGE line label 


name identifying an IMAGE statement 


any valid line label 


IMAGE line 


integer constant identifying an IMAGE statement 


1 through 65,535 


number 






format string 


string expression consisting of one or more field specifiers 
(see I M fl G E for syntax) 


— 


numeric 


— 


— 


expression 






string expression 


— 


— 



Examples 

OUTPUT 70 1 , 792 .: " abcde " , D 1 .: Q* 

U T P U T B u f f e r * U S I H G 3 .; H , fl $ , B , " H e 1 1 o " 

Description 

Bytes of numeric or string data are output to the specified device(s) or I/O buffer. If a 
C N '...' E R T operation is enabled for that device or buffer, the conversion is performed immedi- 
ately before the byte is output. 

Simple OUTPUT (without USING). The simple OUTPUT statement (without USING) outputs 
items using two different field widths: 

■ When items are separated by semicolons, they are output in narrow format. Numbers are 
output in standard number format with a leading blank or minus sign and a trailing space. 
Strings are output with no leading or trailing blanks. 

■ When items are separated by commas, they are output in free field format, left-justified in 
21 -column fields. Numbers are output in standard number format with a leading space or 
minus sign. Trailing spaces are output to fill the unused portion of the field. Strings have 
no leading spaces; trailing spaces are added to fill the field. 
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o 



...OUTPUT 



Automatic End-of-Line Sequence. When the output list is exhausted, an end-of-Line (EOL) 
sequence, ordinarily carriage return/line feed, is sent. The EOL can be suppressed by placing 
the image specifier # at the beginning of the format string in the U T P U T U S I H G or I M fl G E 
statement. The EOL sequence is also suppressed by placing a comma or semicolon at the end 
of the output list in a simple OUTPUT statement. 

Formatted Output. The U T P U T U S I N G statement uses a format string contained in the 
statement itself, or in an accompanying I M fl G E statement, to format the output. The format 
string, consisting of one or more field specifiers separated by delimiters (, or /), is used from 
left to right. Output items are paired with their corresponding field specifiers. A field specifier 
consists of one or more image specifiers. Certain field specifiers do not use a display item (for 
example, X). 

If the format string is exhausted before all the output items have been processed, the format 
string is reused from the beginning. Extra field specifiers are ignored. If a field is larger than 
the numeric item, the number is right-justified in the field. 

A warning is issued if the number is larger than the field, and the number output may be 
incorrect. (A minus sign requires a digit position if M or S is not included in the field specifier.) 
Numbers are rounded to the number of decimal places indicated by the field specifier. 

A trailing comma or semicolon after the last output item is ignored; trailing punctuation does 
not suppress the EOL sequence. 

Refer to I M fl G E for the syntax of the format string. 

Related Keywords 

CONVERT, DISP, IMAGE, IOBUFFER, PRINT, TRANSFER 
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PASS CONTROL 



Keyboard Executable I 
Programmable I 

In an IF...THEH ■ 

The PASS CONTROL statement passes Active Controller responsibility to the specified device. 



( pass control) - 



selector 



Item 


Description 


Range 


device selector 


numeric expression, rounded to an integer (see glossary) 


— 



Examples 

PASS CONTROL 710 
PASS CONTROL 8 
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...PASS CONTROL 



Description 

Interface-dependent action: 

■ HP-IB: 

If the device selector is an interface select code, the specified device must be addressed to 
talk before P fl S S C N T R L is executed. Executing P fi S S C H T R L causes the interface to 
send the Take Control (TCT) message; ATN is set false. 

If the device selector contains a primary address, the interface sends the specified device's 
talk address, followed by the Take Control (TCT) message, and sets ATN false. 

■ HP-IL: 

If the device selector is an interface select code, the recieving device must be addressed to 
talk before P Fl S S C H T R L is executed. Executing P fl S S C N T R L causes the interface to 
send the Take Control (TCT) message. 

If the device selector contains a primary address, the interface sends the specified device's 
talk address, followed by the Take Control (TCT) message. 

■ Serial, BCD, and GPIO: Error. 

Related Keywords 

ABORT 10, ENABLE IHTR, ON INTR, REQUEST, RESET 
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The PAUSE statement pauses program execution. 



PAUSE 



Keyboard Executable □ 
Programmable ■ 

In an IF...THEN ■ 



(pause)- 



Description 

When PAUSE is executed, program execution is suspended at the end of the current line. To 
resume execution, execute COHT. 

If a halted program is edited, it must be initialized before execution can continue. To continue 
an edited program, use RUN, or I HIT followed by CO NT. 

When a program is paused from the keyboard during execution of a multistatement line, the 
line is completed before the program halts. If the line includes a branching statement, execu- 
tion halts at the end of the statement to which the program branched. 

Related Keywords 

CO NT, I NIT, RUN 
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PDIR 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The P D I R (plot direction) statement specifies a rotation of coordinates which is applied to in- 
cremental plotting (I PLOT, I MOVE, and I DRAW) and relative plotting (RPLOT). 



(W> 



angle 



<y~ i 



Item 


Description 


Range 


angle 

run 

rise 


numeric expression, interpreted according to the current 
trigonometric mode 

numeric expression, interpreted according to the current 
scale units 

numeric expression, interpreted according to the current 
scale units 


— 



Examples 

PDIR fiCS<P<I>> 
PDIR 30,30 
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...PDIR 



Description 

The angle measures the conterclockwise rotation between the horizontal axis and the new x- 
axis. The run and rise parameters determine a vector drawn in the direction of the new x-axis. 

Axes and labels are not affected by P D I R . 

Related Keywords 

DEG, GRflD, RflD 
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PEN 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The PEN statement selects a pen on the current plotting device. 



C^> 



pen number 



Item 


Description 


Range 


pen number 


numeric expression, rounded to an integer 


device dependent 



Examples 

PEN -1 
PEN fl 

Description 

On a periperal plotter, no checking is done to verify that the specified pen number exists. Pen 
returns the current pen to the stall. Negative pen numbers are interpreted as pen 0. 



2-300 Keyword Dictionary 



PEN 



When the display is the plotting device, pen numbers are interpreted as follows: 
Graphics Display Pen Operation 



Pen Number 


Effect 


^1 


Plots white dots. 







Pen is deactivated and does not plot. 




-1 or <— 2 


Plots black dots. 




-2 


Performs an exclusive OR, plotting white dots over black dots and black dots over 




white dots. 





Related Keywords 

G CLE FIR 
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PENUP 



Keyboard Executable 
Programmable 

In an IF...THEH 



The PENUP statement lifts the pen on the current plotting device. 



(penup)- 



p Description 

After PENUP is executed, no drawing takes places until the pen is dropped manually or by 
executing a statement that drops the pen: 



PLOT 
DRAW 
XAXIS 
GRID 



IPLOT 
IDRAW 
YAXIS 
LGRID 



RPLOT 
LABEL 
AXES 
LAXES 
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PI 

The P I function returns the value of ir with full machine precision. 



CD— 

Examples 

C=£*PI*R 

IF R<2*PI THEN GOSUB 590 
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PLIST 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The P L I S T statement lists the current program or subprogram in system memory on the 
PRINTER IS device. 



(plist) - 



k_ fc /T\__«J beginnin 
^ H line numb 



L OH 



ending 
line number 



Item 


Description 


Range 


beginning line 
number 

ending line 
number 


integer constant 
integer constant 


1 through 65,535 
1 through 65,535 



Examples 

PLIST 106 
PLIST 106,200 



Description 

The beginning line number and ending line number specify the portion of the program to be 
listed. If no ending line number is specified, listing begins at the beginning line number and 
continues for the entire (sub)program. When both parameters are omitted, the entire program 
is listed. 

Related Keywords 

LIST 
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PLOT 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The PLOT statement moves the pen from the current pen position to the specified x- and y- 
coordinate position. The optional pen control parameter specifies the up/down status of the 
pen. 



(plot) — •■ 



x-coordinate 



o 



y-coordinate 



^o-\ 



pen 
control 



n 



Item 


Description 


Range 


x-coordinate 
y-coordinate 
pen control 


numeric expression, interpreted in the current units 

numeric expression, interpreted in the current units 

numeric expression, rounded to an integer (default= +1 ; pen 
lowered after move) 


— 



Examples 



PLOT 
PLOT 



10 



Description 

PLOT uses the current units (GU's or UU's) and line type. In UU's mode, lines cannot be 
drawn outside the plotting boundaries. In GU's mode, the plotting boundaries are equivalent 
to the graphics limits; therefore, lines can be drawn anywhere within the graphics limits. 

In both UU's mode and GU's mode, PLOT can position the logical pen outside the plotting 
area. However, PLOT cannot position the physical pen outside the plotting boundaries. If 
none of the line is inside the current plotting area, the physical pen is not moved, but the 
logical pen position is updated. 
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...PLOT 



The optional pen control parameter specifies the up and down position of the pen as follows: 
Pen Control 



Pen Control Parameter 


Pen Action 


positive, even 
positive, odd 
negative, even 
negative, odd 


pen moved and then lifted 
pen moved and then lowered 
pen lifted and then moved 
pen lowered and then moved 



If no pen control parameter is specified, the up/down status of the pen before PLOT is exe- 
cuted determines whether the pen is up or down as it moves. If the pen is up, it is lowered 
when it reaches its new position. 

Related Keywords 

I PLOT, LINE TYPE, RPLOT 
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PLOTTER IS 



Keyboard Executable 
Programmable 

In an IF. ..THEN 



The PLOTTER IS statement specifies the device to which graphics output is sent. 



PLOTTER IS 



device 
selector 



Item 


Description 


Range 


device selector 


numeric expression, rounded to the nearest integer 
(default=1) 


see glossary 



Examples 

PLOTTER IS 70S 
PLOTTER IS I 



Description 

In addition to selecting the plotting device, the PLOTTER IS statement: 

■ Reads the graphics limits of the plotting device. 

■ Activates the graphics default conditions (see graphics default conditions in the glossary). 

Related Keywords 

ASSIGN, LIMIT 
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POS 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The POS numeric function returns the position of the first character of a substring within 
another string. 



( pnc ^ */7^ J string I *jT\ J substring I +C\ \ » _ 

V rua J \z/ l searched | \^_J H searched for | \J_J 



Item 


Description 


Range 


string searched 

substring 
searched for 


string expression 
string expression 


— 



Examples 



Index = POS'::fl$, " 1 " > 

D I S P String *CPOS<String*, " L " ■■ , 3 8 1 



Description 

If the substring searched for is the null string or is not contained within the string searched, 
POS returns 0. If the substring searched for occurs in more than one place, only the first 
occurence is returned. 
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PPOLL 



Keyboard Executable 
Programmable 

In an IF...THEN 



The PPOLL numeric function returns the results of a parallel poll operation. 



(^^Q <T) H s^ect^de h ~ »Q) 



Item 


Description 


Range 


interface select 
code 


numeric expression, rounded to an integer 


3 through 10 



Examples 

ParPol=PP0LL<7> 

IF P P L L ■; I s c ) = 8 THE H G S U B 3 8 9 

Description 

Interface-dependent action: 

■ HP-IB and HP-IL: The computer must be active controller. The value returned is a byte 
representing eight status-bit messages of devices on the interface bus. Each device capable 
of responding asserts one bit of the response byte. 

■ Serial, BCD, and GPIO: Error. 

Related Keywords 

SPOLL 
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PRINT 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The PRINT statement outputs the print items to the current PRINTER IS device. 



(print) - 



^-» (using) - 



IMAGE line 
number 



IMAGE line 
label 



G> 




PRINT 

items 



o 



numeric 
expression 



string 
expression 



> — < tab ) -><7)-»|^ 






Trailing punctuation 
ignored with USING. 



TAB not allowed 
with USING. 
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...PRINT 



Item 


Description 


Range 


IMAGE line 


integer constant identifying an IMAGE statement 


1 through 65,535 


number 






IMAGE line label 


name identifying an I M AGE statement 


any valid line 
name 


format string 


string expression containing one or more field specifiers (see 
IMAGE statement for syntax) 


— 


column 


numeric expression, rounded to an integer 


negative numbers 
are interpreted as 
1 


numeric 








expression 






string expression 


— 


— 



Examples 

PR I NT Number .: Letter* 

PR I NT TAB < 1 8 > .: A$ , " Resu 1 t s= " .: Resu 1 t 

PR I NT US I HG " DC3D . 5D , 4X , 7A " : A , " do 1 1 ar s " 

PRINT USING 180; A,B*,C 

Description 

The keyword U S I N G provides for specifying the format of output. When P R I N T is executed 
without USING, a standard format is used. 

Simple PRINT (Without USING). Simple PR I NT uses standard number format (see glossary) 
for numeric items, and displays numeric and string items in either of two field widths: 

■ When display items are separated by semicolons, they are displayed in narrow format with 
a leading blank or minus sign. Strings are output with no leading or trailing blanks. 

■ When display items are separated by commas, they are displayed in wide format, left-justi- 
fied in 21 -column fields. Items longer than 21 characters occupy more than one field. 
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p 



...PRINT 



When the TAB function is included as a print item, the column parameter positions the next 
character on the print line. Negative column numbers are treated as TAB(l). Column numbers 
greater than the line length are reduced MOD (line length). When TAB is used to control 
format, display items should be separated by semicolons; using commas causes output to be 
displayed in wide format. 

When the list of print items is exhausted, an end-of-line (EOL) sequence, ordinarily carriage 
return/line feed, is sent to the printer. The EOL can be suppressed by including a comma or 
semicolon after the last print item. 

Control Characters and Alternate Character Sets. Control characters are included as 
print items by specifying their ASCII code as argument in the C H R $ function or by using the 
metacharacter ~ followed by the character decimal code. 

Formatted Output. The P R I H T U S I N G statement uses a format string contained in the 
statement itself or in a referenced I M fl G E statement to format the output. The format string, 
consisting of one or more field specifiers separated by delimiters (comma or slash), is used 
from left to right. Print items are paired with their corresponding field specifiers. Certain field 
specifiers do not use a print item (for example, X). 

If the format string is exhausted before all the print items have been processed, the format 
string is reused from the beginning. Extra field specifiers are ignored. If a field is larger than 
the numeric item, the number is right-justified in the field. A warning is issued if the number 
is larger than the field. (A minus sign requires a digit position if M or S is not included in the 
field specifier.) Numbers are rounded to the number of decimal placed indicated by the field 
specifier. Standard number format can be chosen by using the image specifier K. 

TAB cannot be used with P R I H T U S I H G . 

When the list of print items is exhausted, an end-of-line (EOL) sequence, ordinarily carriage 
return/line feed, is sent to the display. The EOL can be suppressed by placing the image 
specifier # at the beginning the format string in the PRINT USING or IMAGE statement. 
Unlike with simple PRINT, a terminating semicolon or comma is ignored and does not sup- 
press the EOL sequence. 

Refer to I M A G E for the syntax of the format string. 

Related Keywords 

DISP, IMAGE, OUTPUT 
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PRINT# 



Keyboard Executable 
Programmable 

In an IF...THEN 



The PRIHTtt statement outputs data to an open BASIC/DATA file. 



C 



PRINT* 



buffer 
name 



•—O-He 



'ecord 
lumber 



O 



o 



numeric 
expression 



string 
expression 



<& 



T~K 



ZqJ 



<>)-> 



Item 


Description 


Range 


buffer number 


numeric expression, rounded to an integer 


1 through 10 


record number 


numeric expression, rounded to an integer 


— 


numeric 


(see glossary) 


— 


expression 






string expression 


(see glossary) 


— 


array name 


name of a numeric or string array 


any valid name 



Examples 



PRIHTtt 1.; Variable 

PRIHTtt But" fer Number , record: FK4>#7, B*C7,123 
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...PRINT# 



Description 

The buffer number must have been previously assigned to the file with an fl S S I G N # state- 
ment. The ASSIGN* statement places the file pointer at the beginning of the file. 

Serial Access. When the record number is omitted, data is written serially. In serial access, 
data is written to the file sequentially; items are placed in the next logical record when the 
current record becomes full. 

As each PRINT# item is written into the file, the file pointer advances beyond that data. 
When the entire list of PRINT# items has been written, the file pointer remains positioned 
p after the last data item read and an end-of-file marker is positioned there. A subsequent 
PRINT* statement continues writing data from that position. 

Serial printing continues until all the data is printed, or until the medium is full. The data file 
is automatically expanded, if necessary, to accommodate all the PRINT# items. Serial printing 
also halts when the file is closed, or when a random access R E R D # or P R I H T # is executed. 

Random Access. When the record number is included, data is written using random access. 
The record number must not exceed the total number of records in the file. 

When the P R I H T # statement is executed, the file pointer is moved to the beginning of the 
specified logical record. As an item of data is written into the record, the file pointer advances 
to the next position in the record and an end-of -record marker is placed in that position. A 
random PRINT# operation cannot extend across logical record boundaries. An error is re- 
turned if the file pointer moves beyond the end of the record. 

Executing a random access P R I N T # without a list of data causes the file pointer to move to 
the beginning of the specified logical record. 

Related Keywords 

ASSIGN*, READ* 
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PRINT ALL 



Keyboard Executable 
Programmable 

In an IF...THEN 



The PRINT ALL statement produces a printed copy of alphanumeric information as it is dis- 
played on the alpha display. 



C 



PRINT ALL 



Description 

PRINT ALL directs a copy of all displayed alphanumeric output to the PRINTER IS device. 
This includes output from DI3P, DISP USING, and LIST, keyboard input, and error mes- 
sages generated from the keyboard or from a running program. 

Related Keywords 

CRT IS, PRINTER IS 
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PRINTER IS 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The PRINTER IS statement selects the destination for PRINT and PLIST output. 



( PRINTER IS y 



device 
se 



lector X 

file I J 



K> 



1 ine 
length 



J 



Item 


Description 


Range 


device selector 
file selector 
line length 


numeric expression, rounded to an integer 
numeric expression, rounded to an integer 
numeric expression, rounded to an integer (default=80) 


see glossary 
11 through 20 
1 through 220 



Examples 

PRINTER IS 701 
PRINTER IS PI 
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...PRINTER IS 



Description 

Output from PR I NT (US I NG) and PL I ST is sent to the PRINTER IS device or to the specified 
file. The alpha display is the default printing device at power-on. 

The line length specifies the maximum number of characters sent to the PRINTER IS device 
before an end-of-line (EOL) sequence is automatically sent. The EOL character(s) are not 
counted as part of the line length. When a PRINT USING format string specifies output that 
exceeds the PRINTER IS line length, the line is broken at the line length and the format is 
continued at the beginning of the next line. 

Related Keywords 

ASSIGN, IMAGE, PL I ST, PRINT 
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PURGE 



Keyboard Executable 
Programmable 

In an IF...THEH 



The PURGE statement deletes the entry for the specified file from its directory. 



(purge)- 



O 



file 
name 



HP-UX 
path name 



J 



<y, 



string 
expression 



Item 


Description 


Range 


file name 


literal; name of a file in the current working directory 


14 characters 
maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name 


— 



Examples 



PURGE "myfile" 

PURGE "..■■voll..-dirl,-dir2/my+ ile 
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...PURGE 



Description 

If the file name is used alone rather than as part of an HP-UX path name, the file must be 
located in the current working directory. 

A purged file can no longer be accessed. The space previously occupied by the file becomes 
available for creation of other files. 

Related Keywords 

ASSIGN* 
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RAD 



Keyboard Executable 
Programmable 

In an IF...THEH 



The RfiD statement sets radians as the unit in which angles are measured. 



(rap) *■ 

Description 

When RfiD is executed, all angle parameters in statements and functions are interpreted as 
radians. (There are 2x radians in a circle.) All functions returning an angle return a value in 
radians. 

The angle mode of a program is global. When a subprogram is called, the current angle mode 
is carried into the subprogram. If a subprogram changes the angle mode and then returns to 
the main program, the new mode is carried back to the main program. 

Related Keywords 

DEG, GRfiD 
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RANDOMIZE 



Keyboard Executable 
Programmable 

In an IF...THEH 



The RANDOMIZE statement specifies a new seed for the RND function. 



( bandomizeP) - 



n 



Item 


Description 


Range 


seed 


numeric expression, rounded to an integer 


range of integers 



Examples 

RANDOMIZE 
RANDOMIZE Seed 

Description 

The seed determines the sequence of pseudorandom numbers generated. Using the same seed 
causes RND to generate the same series of numbers. 

The seed is global, and is passed between the main program and any subprogram(s). 

Related Keywords 

RND 
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RATIO 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The RATI function returns the ratio of the dimensions of the graphics limits — horizontal 
dimension divided by vertical dimension. 



(ratio) - 



Examples 

R=RATI0 

LOCATE 5 , RAT I 0*20 , 1 @ , 50 

Description 

The graphics limits from which RATI is computed are set by executing PLOTTER I S or 
LIMIT. 

Related Keywords 

LIMIT, PLOTTER IS 



Keyword Dictionary 2-323 



READ 



Keyboard Executable D 
Programmable ■ 

In an IF...THEM ■ 

The READ statement reads numeric and/or string constants from one or more DATA state- 
ments and assigns those values to program variables. 



(head) 





I w/T^ fc |beginninc 
\»^/ " position 



^-»/TV- *J endin 9 

^^_J position 



Item 


Description 


Range 


numeric name 
string name 
subscript 
beginning position 
ending position 


name of a simple numeric variable or numeric array 
name of a simple string variable or string array 
numeric expression, rounded to an integer 
numeric expression, rounded to an integer 
numeric expression, rounded to an integer 


any valid name 
any valid name 
1 through 65,530 
1 through 65,530 
1 through 65,530 



Examples 



READ Var i ab 1 e 1 , Var i ab 1 e2* 

READ A<1,2>., B,C*,D*C3,5:., E*-::4)C7: 



2-324 Keyword Dictionary 
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Description 

READ uses a data pointer to indicate the data item to be read. When program execution be- 
gins, the data pointer is positioned at the left-most item in the lowest-numbered DflTfl 
statement. When the data list in a particular DATA statement is exhausted, the pointer moves 
to the next-higher numbered DATA statement. Attempting to read past the last data item in 
the program generates an error. 

The order in which DATA statements are used can be changed using the RESTORE statement. 

Each subprogram has its own data pointer, and can use only its own DATA statements. When 
a subprogram is called, its first READ statement uses the first DATA statement in that subpro- 
gram. When execution returns to a calling program, the calling program resumes use of its 
own data pointer starting from the pointer's last position. 

Related Keywords 

DATA, RESTORE 
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READ# 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The REflDtt statement retrieves data from an open BASIC/DATA file and assigns the data to 
the specified variable(s). 



(read*H!S 




record 
number 



o 



o 



numeric 
name 



H3> 



O^ 



subscript 



str ing 
name 



KD- 



On 



r 



subscript 



*©-J 



array 
name 



v w^T^ [beginning! ^/T\ „ 

^*\ L y^ n position n p\i/^ 

L-fc/TV-J ending I J 
\yJJ position 



~& 



Item 


Description 


Range 


buffer number 


numeric expression, rounded to an integer 


1 through 10 


record number 


numeric expression, rounded to an integer 


none 


numeric name 


name of a simple numeric variable or numeric array element 


any valid name 


string name 


name of a simple string variable or string array element 


any valid name 


array name 


name of a numeric or string array 


any valid name 


subscript 


numeric expression, rounded to an integer 


1 through 65,530 


beginning position 


numeric expression, rounded to an integer 


1 through 65,530 


ending position 


numeric expression, rounded to an integer 


1 through 65,530 
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...READ# 



Examples 

REflDtt 1; Variable 

REflDtt Bu f fer Number , recor d .: fl < 4 ) , B*C 7 , 1 2 1 

Description 

The buffer number must have been previously assigned to the file with an fl S S I G N # state- 
ment. The flSSIGHtt statement places the file pointer at the beginning of the file. 

Data read from the file must match the READ# variables in type (numeric versus string). 
Numeric data need not agree in precision. The data is converted to the precision of the 
READ# variable. 

Serial Access. When the record number is omitted, data is read serially. As an item of data 
is read from the file into a READ# variable, the file pointer advances to the next item. When 
the entire list of READ# variables has been satisfied, the file pointer remains positioned after 
the last data item read. A subsequent REflDtt statement continues reading data from that posi- 
tion. Serial access continues until the file is closed, all the data has been read, or a random 
access REflDtt or P R I N T tt statement is executed. 

Random Access. When the record number is included, data is read using random access. 
The record number must not exceed the total number of records in the file. 

When the random REflDtt statement is executed, the file pointer is moved to the beginning of 
the specified logical record. As an item of data is read from the record into a READ# variable, 
the file pointer advances to the next item in the record. A random READ# operation cannot 
extend across logical record boundaries. An error is returned if the file pointer encounters the 
end of the logical record before all the READ# variables have been satisfied. 

Executing a random access REflDtt without a list of variables moves the file pointer to the 
beginning of the specified logical record. 

Related Keywords 

flSSIGNtt, PRINTtt 
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READTIM 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The R E fl D T I M function returns the integer number of seconds elapsed on the specified system 
timer after the timer is set by an N T I M E R # statement in a program. 



( READTIM ) KD" 



timer 
number 



o 



Item 


Description 


Range 


timer number 


a numeric expression, rounded to an integer 


through 3 



Examples 



IF READTIM':: 1 > <5 THEN 
DISP REflDTIM<fl) 



G S U B S e n d D a t a 



Description 

If the timer has not been set or has been disabled by OFF TIMERtt, READTIM returns 0. 
Timer #0 is the system clock; R E fl D T I M < Q ) returns the value of the clock seconds counter. 

Related Keywords 

OFF TIMERtt, ON TIMERtt, SETT I ME 
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REAL 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH □ 

The REAL statement declares and reserves memory for full precision floating point numeric 
variables. 



(real)- 



numeric 
name 



o 



o^ 



MTt- Hls] — L ^oy J 



Item 


Description 


Range 


numeric name 
upper bound 


name of a simple numeric variable or numeric array 
integer constant 


any valid name 
1 through 65,530 



Examples 



REAL '...' a riable.fi r r a y 1 < 1 > , fi r r a y 2 



i ^i . A i 
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R 



...REAL 

Description 

All numeric variables are REAL unless declared SHORT or INTEGER. 

When the numeric variable name is used with one or two upper bound(s) enclosed in paren- 
theses, the variable is dimensioned to be a one- or two-dimensional array. The default lower 
bound of the array is 0. The OPTION EASE statement is used to set the lower bound equal 
to 1. 

When variables are passed to a subprogram by address, precision declarations accompany the 
variable into the subprogram. 

Related Keywords 

DIM, INTEGER, SHORT 
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REDIM 



Keyboard Executable 
Programmable 

In an IF...THEH 

The R E D I M statement changes the subscript range of a previously dimensioned array. 



O 



(m»)-H^]-KD-Hllir-KI) 



O^ 



Item 


Description 


Range 


array name 
lower bound 

upper bound 


name of a numeric array 

numeric expression, rounded to an integer (default = option 
base value) 

numeric expression, rounded to an integer 


any valid name 
1 through 65,530 

1 through 65,630 



Examples 



REDIM fl<3) 

RED IN First fir ray (4, 5 



> , S e c o n d Fl r r a y < 5 > 
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...REDIM 



Description 

Redimensioning an array reassigns elements to different positions in the array. Elements are 
stored in order from left to right along each row, from the top row to the bottom. 

The following rules apply to redimensioning arrays: 

■ The number of dimensions of the array must not change. 

■ The total number of elements in the new working size cannot exceed the number originally 
dimensioned. 

If R E D I M specifies an array that has not yet been explicitly dimensioned, the array is first 
dimensioned to a two-dimensional array with upper bounds equal to 10, and then immedi- 
ately redimensioned. 
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The REM statement allows comments in a program. 



Keyboard Executable □ 
Programmable ■ 

In an IF. ..THEN □ 



( rem) - 



BASIC program fc /| 
line ' w - 




^-*« literal ' 



Item 


Description 


Range 


literal 

BASIC program 
line 


string constant composed of characters from the keyboard 
a proper BASIC statement or multistatement line 


characters with 
ASCII codes 
through 31 not 
allowed 



Examples 

10 REM Written 1 2 ,- 5 / 8 3 

£0 ! 

30 DISP "Insert disc in drive" ! User must insert disc #4 

Description 

The comment delimiter, ! , can be used anywhere after the line number; all characters follow- 
ing the delimiter are considered part of the comment. 

If a REM statement is included in a multistatement line, it must be the last statement 
in the line. 
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REMOTE 



Keyboard Executable 
Programmable 

In an IF...THEN 



The REMOTE statement places the specified device(s) into remote control. 



c^j> *-» nisfi 



o-^ 



Item 


Description 


Range 


device selector 


numeric expression, rounded to an integer (see glossary) 


— 



Examples 

REMOTE 718 
REMOTE Hl,H2,fl; 
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...REMOTE 



Description 

If two or more device selectors are listed, they must include primary addresses, and the de- 
vices must be on the same interface. If the device selector is an interface select code, the 
remote state is enabled for all devices on the bus having remote/local capabilities. 

Interface-dependent action: 

■ HP-IB: The computer must be system controller. The bus is placed into remote operation. 

If the device selector is an interface select code, the interface sets Remote Enable (REN) true. 
Devices do not go into remote state until they are addressed to listen. 

If the device selector contains a primary address, the interface sets REN true, sends Unlisten 
(UNL), and then sends the listen address of the specified device(s). REMOTE leaves ATN 
true. 

■ HP-IL: The computer must be active controller. 

If the device selector is an interface select code, Remote Enable (REN) is sent. 

If the device selector(s) include a primary address, Remote Enable (REN), Unlisten (UNL), 
and Listen Address (LAD) are sent. 

■ BCD: Sets a partial field separator. 

■ Serial and GPIO: Error. 

Related Keywords 

LOCAL, LOCAL LOCKOUT, RESUME 
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REN 



Keyboard Executable ■ 
Programmable D 

In an IF...THEH □ 

The REN command renumbers all or portions of the current program or subprogram. 



(ren> 



I new initial 



line number 



V. „ f ~ \ __ new increment 
^\J*/ \ value 



L ^f~\ fc original in 
\^_y \ line numt 



itial 
mber 



I ^f~\ fc original endinc 
\JJ line number 



Item 


Description 


Range 


new initial line 
number 


integer constant (default =10) 


1 through 65,535 


new increment 
value 


integer constant (default = 10) 


1 through 65,535 


original initial line 
number 


integer constant (default=1) 


1 through 65,535 


original ending 
line number 


integer constant (default =65,535) 


1 through 65,535 



Examples 

R E N 5 .. 2 , 1,6 
REN 10,1 
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Description 

The program lines to be renumbered are delimited by the original initial line number and the 
original ending line number. Both original line numbers must exist in the program. The first 
line in the delimited segment is assigned the new initial line number. Successive lines are 
renumbered according to the specified new increment value. An error occurs if renumbering 
causes the new ending line number to exceed 65,535, or if either original line number does not 
exist. 

When R E N changes a line number, all references to that line number within the (sub)program 
(for example, GOTO line number) are automatically updated. 

REN cannot be used to change the order of program lines. An error occurs if renumbering 
causes newly renumbered program lines to overlap previous or following lines. In the case of 
an error, renumbering halts and line numbers are returned to their original values. 

Related Keywords 

SCAN, XREF L 
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RENAME 



Keyboard Executable 
Programmable 

In an IF...THEH 



The RENAME statement changes the name of the specified file in its directory. 



( RENAME ) -r~K^) 



file 
name 



HP-UX 
path name 



J 



t <Dr^jD-*(iHJS 1 



string 
expression 



Item 


Description 


Range 


file name 


literal; name of a file in the current working directory 


14 characters 
maximum; slash 
and leading colon 
not allowed, 
BASIC/SUBP files 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


BASIC/SUBP files 
not allowed 


string expression 


expression evaluating to a file name or HP-UX path name 


— 



Examples 



R E H fl M E " r. a m el" T " n a m e 2 " 

R E H H M E " / disci / o 1 d n a m e " T " n e w n a m e 
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...RENAME 



Description 

RENAME removes the old name from the directory and replaces it with the new name. The 
parameter following TO must be a simple file name. 

If the old file name is used alone rather than as part of the HP-UX path name, the file must 
be located in the current working directory. 
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REPLACEVAR 



Keyboard Executable ■ 
Programmable D 

In an IF...THEH □ 

The REPLRCEURR command replaces all occurrences of the specified variable name in a pro- 
gram or subprogram with another variable name. 



C 



REPLACEVAR 



iable | ^J-/ 



X^J 



*Oy*C^ H va a nTa a b y ie K O 



i^r 



QyJ 



Item 


Description 


Range 


simple variable 
name 

array variable 
name 


simple numeric or string variable name 
numeric or string array name 


any valid name 
any valid name 



Examples 



REPLACE 1 ., 1 flR A BY B 

REPLACE VHR string *0 BY twinetO 
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...REPLACEVAR 



Description 

The new variable name must match the replaced variable name in type — simple numeric, sim- 
ple string, numeric array, or string array. A one-dimensional array variable is indicated by 
parentheses following the variable name. For two-dimensional arrays, a comma must be in- 
cluded within the parentheses. 

The messages R e p 1 a c i ng . . , and , , .en d o t repl a c e indicate the beginning and end 
of the replacement operation. 

Related Keywords 

SCfiN, XREF L, XREF V 
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REQUEST 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The REQUEST statement is used by the non-active controller to send a response byte to the 
active controller. 







REQUEST 



interface 
select code 



O-H 



response 
byte 



Item 


Description 


Range 


interface select 
code 

response byte 


numeric expression, rounded to an integer 

numeric expression, truncated to an integer and moduloed 
256 


3 through 10 



Examples 

REQUEST 7.! 64 
REQUEST Iscj64+J 



Description 

Interface-dependent action: 

■ HP-IB and HP-IL: The computer must be non-controller. Executing REQUEST sets up a 
serial poll response byte, which is sent to the active controller in response to a serial poll 
operation. If bit 6 (decimal value 64) of the response byte is set, the computer sends Service 
Request (SRQ) to the active controller in response to the incoming serial poll. The active 
controller's serial poll clears SRQ. 
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...REQUEST 



■ Serial: A BREAK, defined by the response byte, is sent. The transmit line is held in a space 
condition (0 -state) for the number of character times specified in the response byte, fol- 
lowed by a mark condition (1 -state) for five character times. 

■ BCD and GPIO: Error. 

Related Keywords 

PASS CONTROL, SPOLL 
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Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The R E S E T statement performs a hardware reset of the interface, returning it to its power-on 
state. 



(reset) — ►- 



interface 
select code 



Item 


Description 


Range 


interface select 
code 


numeric expression, rounded to an integer 


3 through 10 



Examples 

RESET 7, RESER Isc 

Description 

When RESET is executed, the interface performs a self -test, and the control registers are set to 
their default values. 

If EOT branching is enabled, resetting the interface during an active transfer causes the 
branch to be taken. 



2-344 Keyword Dictionary 



Interface-dependent action: 

■ HP-IB: If the computer is system controller, HP-IB sends Interface Clear (IFC), then Remote 
Enable (REN). 

■ Serial: Modem control lines are turned off. 

■ BCD: Data lines are set to high-impedance state, handshake lines are set false, and I/O 
lines are set to input state. 

■ GPIO: Ports A and B are set to high-impedance state, ports C and D are set to off state, 
CTL lines are set false, and OUTA and OUTB are set to indicate output. 

■ HP-IL: If the interface is system controller, Interface Clear (IFC), Auto Address Unconfigure 
(AAU), and Auto Address 1 (AAD1) are sent, followed by Not Remote Enable (NRE) and 
Remote Enable (REN). 

Related Keywords 

ABORT 10, HALT, ON EOT 
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RESTORE 



Keyboard Executable 
Programmable 

In an IF...THEN 



□ 



The RESTORE statement specifies which DflTR statement will be accessed by the next READ 
operation. 



( RESTORE y 







< 




1 ine 
number 




* 


m 










line 
label 









Item 


Description 


Range 


line number 
line label 


integer constant identifying a program line (default = first 
DflTFi statement in a program or subprogram) 

name of a program line 


1 through 65,535 
any valid name 



Examples 

190 RESTORE 
200 RESTORE 130 



Description 

The specified statement must be a DflTR statement located in the same program or subpro- 
gram. When that data statement has been used, the data pointer moves to the next-higher 
numbered DflTR statement. 



Related Keywords 



DATA, READ 
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RESUME 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The R E S U M E statement re-enables I/O operations after they have been disabled by execution 
of HALT or SEND. 



( RESUME y 



interface 
select code 



Item 


Description 


Range 


interface select 
code 


numeric expression, rounded to an integer 


3 through 10 



Examples 

RESUME 7 
RESUME Isc 



Description 

Interface-dependent action: 

■ HP-IB: The computer must be active controller. The ATN line is set false. 

■ Serial: The transmitter is enabled (refer to the interface documentation for additional 
information). 

■ HP-IL: The computer must be active controller. The Send Data (SDA) message is sent if a 
transfer is not already in progress. 

■ BCD and GPIO: Error. 



Related Keywords 

CONTROL, HALT, SEND 
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RETURN 



Keyboard Executable D 
Programmable ■ 

In an IF... THEN ■ 

The RETURN statement is used within a subroutine to cause branching to the statement fol- 
lowing the invoking GOSUB. 



( RETURN ) *■ 

Description 

When an invoking GOSUB (or ON. ..GOSUB) is embedded in a multistatement line, RETURN 
returns program execution to the statement following the GOSUB on that line. A GOSUB inter- 
rupt (for example, ON KEY# 5 GOSUB 100) returns execution to the line following the line 
on which the interrupt occurred. 

Related Keywords 

GOSUB, ON...GOSUB 
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REV$ 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The RE '...'$ function returns a string formed by reversing the sequence of characters in the 
specified string. 



C^y-^ry- H ,^^s° t \ —+oy 



Item 


Description 


Range 


string argument 


string expression 


— 



Examples 



Backwards*=REV$< "HBCDE" > 
DISP REV*<String*C2,7:> 
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RMD 



The RMD function divides the first numeric argument by the second numeric argument and 
returns the remainder from the division. 



r RMD J ""CO *" dividend *\'J *" divisor "\0 



Item 


Description 


Range 


dividend 
divisor 


numeric expression 
numeric expression 


— 



Examples 

flNGLE = RMD<Ifl, 360 > 

IF RMD ■:::=•=:, V>=0 THEN 300 

Description 

For non-zero values of Y, RMD(X,Y) returns a value according to the equation: 

RMD(X,Y) = X-Y * IP(X/Y) 

When y=0, RMD(X,Y)=X. RMD and the MOD operator return the same result when X and Y 
have the same sign. 

Related Keywords 

MOD 
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RNP 

The R H D function returns a pseudorandom number greater than or equal to and less than 1 . 



( rnd y 



Examples 

IF RND>.5 THEN DISP "HEADS" 

Description 

The sequence of random numbers returned depends on the seed. BASIC uses a default seed 
whenever the system is reset. The R fl H D M I Z E statement is used to change the seed. 

Related Keywords 

RANDOMIZE 
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RNORM 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The RNORM function returns the row norm of an array. The row norm is computed by sum- 
ming the absolute values of the elements in each row of the array and selecting the largest 
value. 



(™fy— Hj)— H "nTmV I — »(?>— » 



Item 


Description 


Range 


array name 


name of a one- or two-dimensional array 


any valid name 



Examples 



SUM=RNORM<flrrayl > 

IF RNORM<Fl>uRNORM'::C> THEN B = RNORM<fl 



Related Keywords 

C H R M , F H R M , R N R M R W 
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RNORMROW 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN I 

The RNORMROW function returns the row number of the row having the largest sum of abso- 
lute values, using the array specified in the most recently executed RHORM function. 



(rnormrow)- 



Examples 

FK RNORMROW, 3> = 2 , 5E4 
DISP RNORMROW 



Description 

Row numbering starts with zero for option base 0. 

Related Keywords 

RBSUM, RNORM 
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ROTATES 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The ROTATE* function shifts the characters in a string by the specified number of positions, 
rotating characters "bumped" off one end of the string to the other end. 



(rotates) — i-(T)- 



string 
argument 



OH^M5> 



Item 


Description 


Range 


string argument 
shift factor 


string expression 

numeric expression, rounded to an integer 


— 



Examples 



DISP ROTflTE$< "ABCDEFG 
IF ROTATE* (Linel*, 1 >= 



THEN 



Description 

The sign of the shift factor determines which way characters are rotated. A positive shift 
factor causes characters to be right-shifted, with characters at the end of the string rotated to 
the beginning. A negative shift factor causes characters to be left-shifted, with characters at 
the beginning of the string rotated to the end. 
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RPLOT 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The RPLOT statement moves the pen from the current pen position to the specified x- and y- 
coordinate position, using a local coordinate origin. The optional pen control parameter 
specifies the up/down status of the pen. 



(rplot) - 



x-coordinate 



-&( > J »■ y-coordin 



wTV— J p^ I— J 

^ n control J 



Item 


Description 


Range 


x-coordinate 
y-coordinate 
pen control 


numeric expression, interpreted in the current units 

numeric expression, interpreted in the current units 

numeric expression, rounded to an integer (default = 1; pen 
lowered after move) 


— 



Examples 

RPLOT *,Y,P 
RPLOT 5,18 



Description 

The x- and y-coordinates are interpreted as increments to a local origin. R P L T does not affect 
the local origin. 

The local origin is the current logical pen position at the completion of any of the following 
statements: 

AtfES DRAW FRAME GRID I DRAW I MOVE I PLOT LABEL MOVE PLOT 
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...RPLOT 



RPLOT uses the current units (GU's or UU's) and line type. In UU's mode, lines cannot be 
drawn outside the plotting boundaries. In GU's mode, the plotting boundaries are equivalent 
of the graphics limits; therefore, lines can be drawn anywhere within the graphics limits. 

In both UU's mode and GU's mode, RPLOT can position the logical pen outside the plotting 
area. However, RPLOT cannot position the physical pen outside the plotting boundaries. 

The optional pen control parameter specifies the up and down position of the pen as follows: 

Pen Control 



Pen Control Parameter 


Pen Action 


positive, even 
positive, odd 
negative, even 
negative, odd 


pen moved and then lifted 
pen moved and then lowered 
pen lifted and then moved 
pen lowered and then moved 



If no pen control parameter is specified, the up/down status of the pen before RPLOT is 
executed determines whether the pen is up or down as it moves. If the pen is up, it is lowered 
when it reaches its new position. 

Related Keywords 

I PLOT, LINE TYPE, PLOT 
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RPT$ 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The RPT$ function returns a string consisting of the string argument repeated the specified 
number of times. 



(RPT$) *(T)- 



string 
argument 



■o 



repeat 
factor 



o 



Item 


Description 


Range 


string argument 
repeat factor 


string expression 

numeric expression, rounded to an integer 


— 



Examples 

DISP RPT*<Str ing*,5> 
Q$=RPT*< "12345 "/N> 

Description 

A repeat factor less than + 1 returns a null string. A repeat factor that produces a result string 
greater than 65,530 characters causes an error. 
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RTD 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The RTD (radians-to-degrees) function interprets the numeric argument as an angle measured 
in radians, and returns the value of the angle in degrees. 



C^O— > o 



numeric 
argument 



o 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 

D eg r e e s = R T D >'. R a d i a n s > 

DISP rtd<pi*b::< 

Description 

The argument and value returned by RTD are independent of the current trigonometric mode. 

Related Keywords 

DTR 
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RUN 



Keyboard Executable ■ 
Programmable □ 

In an IF—THEN D 

The RUN command starts program execution from the beginning or from the specified line. 



( RUn)- 



l J line I J 



Item 


Description 


Range 


line number 


integer constant (default = first program line) 


1 through 65,535 



Examples 

RUN 

RUN 4509 



Description 

If a line number is specified, it must be a valid line number in the main program. If the main 
program does not contain the specified line, execution starts at the next higher number line. 
An error results if no higher numbered line exists. 

Execution of RUN occurs in two steps — prerun initialization and program execution. During 
prerun initialization: 

■ Memory is allocated to all program variables, and the variables are set to and the null 
string. 

■ Any variable assignments previously made from the keyboard are scratched. 

■ The program is checked for prerun errors; for example, referencing a non-existent state- 
ment, duplicate user-defined functions, dimensioning the same variable more than once. 

If an error is detected, prerun halts and an error message is returned. 
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.RUN 



When prerun initialization is completed, program execution begins. If the specified line num- 
ber does not exist, execution begins with the next higher numbered line. 

Refer to the table of Reset Conditions on pages 4-8 and 4-9 for additional information. 

Related Keywords 

CO NT, I NIT, PAUSE 
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SAVE 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The SAVE statement converts program lines currently in memory to ASCII character strings 
and copies the strings to the specified text file. 



(save)- 



O 



file 
name 



■o 



HP-UX 
path name 



< 



string 
expression 



— r^ J \ I 

I fc/7) «. beginnin 
J ^\Ls i line numb 



I fc/~^ fcl ending 

\^V/ line numbe 



Item 


Description 


Range 


file name 

HP-UX path name 

string expression 

beginning line 
number 

ending line 
number 


literal; name of a file in the current working directory 

literal; an absolute or relative path name (see glossary) 
expression evaluating to a file name or HP-UX path name 
integer constant (default = first program line) 

integer contant (default = last program line) 


14 characters 
maximum; slash 
and leading colon 
not allowed 

1 through 65,535 
1 through 65,535 



Examples 

S fl '.,' E " p o r poise: 
SAVE "Our Ship" 



-i n , ?00 
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...SAVE 



Description 

If the specified file of the proper type already exists, the saved lines are copied to that file, 
erasing and overwriting the current contents. If the file does not exist, it is created in the 
specified directory. The current working directory is used if the file name is used without an 
HP-UX path name. 

The beginning line number and ending line number specify the portion of the program to be 
saved. If the ending line number is omitted, lines from the beginning line number to the end 
of the program are saved. If both parameters are omitted, the entire program is saved. 

The text files created and accessed by SfiUE are non-BASIC files. 

Related Keywords 

GET, STORE 
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SCALE 



Keyboard Executable 
Programmable 

In an IF...THEN 



The SCALE statement specifies a user units scale of the plotting area. 



(SCALE) »» x-min *\0 *" x_max *"C0 *" y ~ min ""CO" 



Item 


Description 


Range 


x-min 
x-max 
y-min 
y-max 


numeric expression 
numeric expression 
numeric expression 
numeric expression 


— 



Examples 

S C fi L E , 1 , , 1 

S C fi L E G , G +3 ., G - 5 tf , 2 G 

Description 

S C fi L E scales the current plotting area, which is a function of the units mode (G U's or UU's) 
and the previously executed statements. 

■ In GU's mode, S C fi L E scales the entire graphics area previously specified by PLOTTER I S 
or LIMIT. 

■ In UU's mode, S C fi L E scales the plotting area previously specified by L C fi T E . If L C fi T E 
has not been executed, the entire graphics area is scaled. 
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...SCALE 



The SCALE statement must be executed after the plotting area (graphics limits or LOCATE- 
defined area) has been established. Regardless of the current units mode, executing SCALE 
leaves the system in UU's mode. 

SCALE parameters can be exchanged to reflect the plot (see LIMIT). 

Related Keywords 

LIMIT, LOCATE, MSCALE, SHOW, PLOTTER IS, SETGU, SETUU 
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SCAN 



Keyboard Executable ■ 
Programmable □ 

In an IF...THEH D 

The SCAN command searches the current program or subprogram and displays all lines con- 
taining the specified variable name or character string. The messages S c a n n i ng , , , and 
, , , end of scan indicate the beginning and end of the scan operation. 



(scan) - 



»/^ J Lfc/T^) J line I / 

V_y ^vl/ ^number] 



O 



simple 
variable 



Taj Ifc/TV 
iable | \2y 



t^r 



ov 



Item 


Description 


Range 


literal 


string constant composed of characters from the keyboard 


— 


simple variable 


name of simple numeric or string variable 


— 


array variable 


name of numeric or string array 


— 


line number 


integer constant identifying a program line (default = first pro- 
gram line) 


1 through 65,535 



Examples 

SCAN no 

SCAN "CALL"., 2000 



Related Keywords 

REPLACE 1 .,' AR, XREF L, XREF 
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SCRATCH 



Keyboard Executable ■ 
Programmable □ 

In an IF...THEN □ 

The SCRATCH command erases portions of computer memory, including the current BASIC 
program, subprogram(s), and variable assignments. 



( SCRATCH ) *- 

Description 

Executing SCRATCH: 

■ Erases the current BASIC program. 

■ Erases any subprograms in memory. 

■ Erases all variable assignments made from the keyboard or within programs, including com- 
mon variables. 

■ Cancels all I/O buffer and mass storage buffer assignments. 
Binary programs are not affected. 

Refer to the table of Reset Conditions on pages 4-8 and 4-9 for further information. 

Related Keywords 

INIT, SCRATCH SUB 



2-366 Keyword Dictionary 



SCRATCHBIN 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The SCRATCHBIN statement erases the specified binary program from BASIC memory and 
reclaims the memory used by the binary. 



C 



SCRATCHBIN 



>T*CK]MLK!>r- 



string 
expression 



Item 


Description 


Range 


file name 

string expression 


literal; name of the binary program 
expression evaluating to a file name 


14 characters 
maximum; slash 
and leading colon 
not allowed 



Examples 



SCRRTCHB I N " t h i sb i nar y 
SCRATCHBIN A* 

Related Keywords 

CALLBIH 
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SCRATCHSUB 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The SCRATCHSUB statement scratches the specified subprogram(s) from system memory. 







SCRATCHSUB 



"N-VVNj subprogram l^/^iTN 
/~*\ y~ n name \ ~*\ ) 



^-»( TO END ) — ' 



Item 


Description 


Range 


subprogram name 


name of the subprogram to be scratched 


14 characters 
maximum; slash 
and leading colon 
not allowed 



s Examples 



SCRATCHSUB "SubSort" 
S C RAT C H SU B "DeleteData 



TO END 



Description 

SCRATCHSUB deletes the specified subprogram(s) without affecting the main program or 
other subprograms. When SCRATCHSUB is executed without the optional TO END keywords, 
only the specified subprogram is scratched. When S C RAT C H S U B is executed from the keyboard 
with the optional TO END keywords, the specified subprogram and all subprograms located 
after it in the directory listing are scratched. 

SCRATCHSUB can be executed within the main program or within subprograms. However, a 
subprogram cannot scratch itself ar any subprogram from which it was directly or indirectly 
called. 

Related Keywords 

DIRECTORY, SCRATCH 
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Keyboard Executable 
Programmable 

In an IF...THEH 



The SEC function returns the secant of the angle argument. 



c^y-*o 



numeric 
argument 



-©■ 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 



C = SEC < Ping 1 e > 

IF SEC<flngle>=T THEN 490 



Description 

The angle argument is interpreted according to the current trigonometric mode — RAD (radi- 
ans), DEG (degrees), or GRAD (grads). The default mode is RAD. 

Related Keywords 

DEG, GRflD, RflD 
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SECURE 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The SECURE statement secures BASIC files against being listed, copied, or overwritten. 



( SECURE )-r-K T ) 



file 
name 



HP-UX 
path name 



string 
expression 



Ot-CXM 



Item 


Description 


Range 


file name 

HP-UX path name 
string expression 
security code 
security type 


literal; name of a file in the current working directory 

literal; an absolute or relative path name (see glossary) 
expression evaluating to a file name or HP-UX path name 
string expression; only the first two characters are used 
numeric expression, rounded to an integer and moduloed 4 


14 characters 
maximum; slash 
and leading colon 
not allowed 

>2 characters 

security type 3 is 
ignored 



Examples 



SECURE "myfile", "nl",8 

SECURE ",--voll,-dir 1 ,-d i r 2,-d i r 3..-my t il 
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...SECURE 



Description 

If the file name is used alone (rather than as part of an HP-UX path name), the file must be in 
the current working directory. 

The security code is associated with the file for security types and 1 only. The first two 
characters are used; any others are ignored. 

Non-BASIC files cannot be secured within BASIC. 

File Security 



Security Type 


File Type 


Protection 



1 
2 


BASIC/PROG 
BASIC/SUBP 

BASIC/PROG 
BASIC/SUBP 

BASIC/PROG 
BASIC/SUBP 
BASIC/DATA 
BASIC/GRAF 


Prevents LIST, PLIST, and editing. 

Prevents LIST, PLIST, editing, and file-to-file COPY. The file is ig- 
nored during directory-to-directory COPY. 

Prevents the file from being overwritten by STORE, GSTORE, or 
PRINT#. 



A file can be secured with types 0, 1, and 2 security at the same time. However, a file cannot 
be secured twice with the same security type. 

Files can be secured against cataloging by using a period as the first character of the file name. 
The file will not be listed in a directory catalog. However, the file itself can be cataloged (i.e., 
CAT "filename" or CAT "HP-UX path name"). 

Regardless of the security status of a file, it can always be purged. 

Related Keywords 

PURGE, UHSECURE 
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SEND 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The SEND statement sends the specified command(s) or data to one or more devices. 



QSENDJ — ■*■ se iect code ~*\iy"^ 



-»(pata)- 



-» ( cmd y 1 - 



O 



numeric 



expression T 
sJ string 1 J 



expression 



o 



numeric 
expr 



ression T~^ I ~~~ T 

tFiHi — i_j mCel}-^ 



expression 



-Q^y*\~S 



imary 
jdress 



-» ( LISTEN > H^ 



o 



imapy 
Jress 



-» ( SCG ) - 

-» (unl) - 

-» ( UNT ) - 

-» ( mta y 



{h 



f I primary 
address 
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Examples 



SEND 7.: CMD A* DflTfi "Hello" 

SEND 7: MTfl UHL LISTEN 6, 14 CMD P,R SC 



...SEND 



Item 


Description 


Range 


interface select 


numeric expression, rounded to an integer 


3 through 10 


code 






primary address 


numeric expression, rounded to an integer 


through 31 


secondary 


numeric expression, rounded to an integer 


through 31 


address 







Description 

The secondary keywords that can be used and the action taken are interface-dependent. 

HP-IB. The computer must be active controller when commands are sent. The ATN line is set 
true while commands are sent; the ATN line is set false while data is sent. 

■ CMD (commands) — sends a list of 8-bit expressions with ATN true. Primary commands have 
a bit pattern in the form XOOCCCCC, where X= don't care and C=bits of the command 
(decimal value through 31). 

■ DATA (data) — sends list of numeric or string expressions with ATN false. Any 8-bit pattern 
may be sent. If EOL is specified, the interface end-of-line sequence is sent following the 
data. 

■ TALK — sends a device Talk Address (TAD), decimal value through 31. 

■ LISTEN — sends a device Listen Address (LAD), decimal value through 31. 

■ SCG (secondary command group) — sends a secondary address to a device. 

■ UHL — sends the Unlisten command (decimal value 63). ATN is true. 

■ UNT — sends the Untalk command (decimal value 95). ATN is true. 

■ MLfl (My Listen Address) — sends the listen address of the interface. 

■ MTfl (My Talk Address) — sends the talk address of the interface. 

Serial. The only form that can be sent is DATA, which sends the list of numeric and/or string 
expressions. If EOL is specified, the interface end-of-line sequence is sent. 
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...SEND 



BCD. UNL, LINT, ML A, and MTfl are ignored. SCG returns an error. The following forms can be 
used: 

■ CMD (command), LISTEN, and TALK — primary addresses through 6 set a partial field 
specifier. 

■ DRTfl (data) — the lower 4 bits of the data bytes are sent; control characters, spaces, and 
commas are ignored. If EOL is specified, data format checking is enabled. 

GPIO. UNL, UNT, MLR, and MTfl are ignored. SCG returns an error. The following forms can 
be used: 

■ CMD (command) — primary addresses through 15 select port configuration. The Device 
Clear command pulses RESA and RESB. Selected Device Clear pulses RESA or RESB ac- 
cording to the most recent primary address. 

■ DATA — sends the list of numeric and/or string expressions. Data is sent as 8 -bit bytes. If 
EOL is specified, the interface end-of-line sequence is sent. 

■ LISTEN, TALK — primary addresses through 15 select the port configuration. 

HP-IL. The following forms can be used: 

■ CMD (command) — sends the list of 8-bit expressions as command frames. 

■ DATA — sends the list of 8-bit expressions as data frames. If EOL is specified, the interface 
end-of-line sequence is sent following the data. 

■ TALK — sends a device Talk Address, decimal value through 31. 

■ LISTEN — sends the device Listen Address(es), decimal value through 31. 

■ SCG (secondary command group) — sends a secondary address frame, decimal value 
through 31. 

■ UNL — sends an Auto Address Sequence and the Unlisten command frame. 

■ UNT — sends an Untalk command frame. 

■ ML A (My Listen Address) — addresses the interface to listen. 

■ MTA (My Talk Address) — sends the Talk Address of the interface. 

Related Keywords 

OUTPUT 
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SETGU 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The SETGU statement sets the computer to graphics units (GU's) mode. In GU's mode, the 
plotting boundaries are equal to the graphics limits, and the plotting area is scaled in graphics 
units. 



( SETGU ) m- 

Examples 

SETGU 

IF XttO THEN SETGU 

Description 

A graphics unit (GU) is defined as Vioo of the shortest axis on the plotting device. 

S 
At power-on, reset, and when LIMIT or PLOTTER I S is executed, the computer is set to user 

units mode, with user units (UU's) set equal to graphics units. SCALE , M SCALE, or SHOW 

establish new user units. Executing SETGU permits plotting in GU's. After executing SETGU, 

plotting can be restored to previously established user units by executing SETUU. 

Executing S E T G U sets the plotting boundary to the graphics limits established by LIMIT or 
PLOTTER IS. In GU's mode, plotting boundaries set by LOCATE or CLIP are not active. 

Related Keywords 

LIMIT, LOCATE, MSCALE, PLOTTER IS, SCALE, SETUU, SHOW 
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I/O 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The SET I / statement writes a byte of data to the specified interface register. 



( ^SET I/O J »• select code vlx 



register 
number 



OH 



byte 



Item 


Description 


Range 


interface select 


numeric expression, rounded to an integer 


3 through 10 


code 






register number 


numeric expression, rounded to an integer 


through 23 


data byte 


numeric expression, truncated to an integer and moduloed 
256 


— 



Examples 

SET 1,-0 7, 16, 3 

SET I.--0 I sc, Reg Num.. BTD-:: "1000001 1 " > 

Description 

The binary equivalent of the data byte is used to set and clear bits of the specified control 
register. SET I / performs the same operation as the C H T R L statement, except that 
SET I.--0 can write to only one register at a time. 

Related Keywords 

CONTROL 
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SET TIMEOUT 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The SET T I M E U T statement sets the maximum amount of time the system will wait for the 
specified interface to complete a handshake during an I/O operation. 



Q 



SET TIMEOUT 



> 



interface 
select code 



OH 



mil liseconds 



Item 


Description 


Range 


interface select 
code 

milliseconds 


numeric expression, rounded to an integer 
numeric expression, rounded to an integer 


3 through 10 
>0 



Examples 

SET TIMEOUT 7.; 10808 
SET TIMEOUT Si: T 

Description 

If an ON TIMEOUT end-of-line branch has been enabled, the branch is taken when the SET 
TIMEOUT limit is exceeded. If no ON TIMEOUT branching is in effect when the SET 
TIMEOUT time limit is exceeded, the system retains a pending end-of-line branch; when an 
OH TIMEOUT statement is executed, the branch is immediately taken. 

I/O operations for which timeouts can occur include any OUTPUT, ENTER, TRANSFER, 
PRINT, and plotting operations that access an interface. 
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...SET TIMEOUT 



A timeout will not occur when a peripheral device stops handshaking in the middle of a 
transfer operation (TRANSFER INTR or TRANSFER F H S ). However, a transfer can timeout 
if the interface or device cannot be addressed to start the transfer. 



Related Keywords 

OFF TIMEOUT, ON TIMEOUT 
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SETUU 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The SETUU statement sets the computer to user units (UU's) mode. In UU's mode, user units 
are the current unit scaling of the plotting area. 



(setuu)- 



Examples 

SETUU 

IF Y*="Y" THEN SETUU 

Description 

When S E T U U is executed, plotting boundaries set by L C fl T E or C LIP which were previously 
canceled by SETGU are reactivated. If that plotting area was previously scaled by SCALE, g 
SHOW, or M SCALE, those user units are reactivated. 

Executing SCALE, SHOW, or MS C ALE also places the system in UU's mode. 

Related Keywords 

CLIP, LIMIT, LOCATE, PLOTTER IS, SETGU 
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SFLAG 



Keyboard Executable 
Programmable 

In an IF...THEN 



The SFLflG statement sets and clears one or more flags. 



(sflag) - 



C_^ flag 
"number 
strint 



expression 



Item 


Description 


Range 


flag number 
string expression 


numeric expression, rounded to an integer 

eight characters, each interpreted as eight data bits 


+ 1 through +64 

(use C H R * or the 
metacharacter ~ 
for non-keyboard 
characters) 



Examples 



IF X=5 THEN SFLflG 6 

SFLflG I 

SFLflG "abcdefgh" 
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...SFLAG 



Description 



When the SFLAG parameter is a numeric expression, it is interpreted as a flag number, and 
the specified flag is set. When the SFLAG parameter is a string expression, each of the eight 
characters are interpreted as one byte. The 8-bit binary value of each character sets (1) and 
clears (0) eight flags. The first character represents flags 1 through 8, the second character, 
flags 9 through 16, etc. If the string expression contains more than eight characters, it is trun- 
cated after the eighth character. If the string expression contains fewer than eight characters, 
CHR$(0) characters are appended to fill the string, and those flags are cleared. 

Related Keywords 

CFLflG, FLAG, FLAG* 
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SGN 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The S G N function returns 1 if the numeric argument is positive, — 1 if the argument is nega- 
tive, and if the argument is 0. 



G^y-*G> 



numeric 
argument 



o 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 



IF SGN'::Y> = 1 THEN GOSUB 40@ 
e Root=SGN<K>*SQR | ::flBS<<; : -0> 

Related Keywords 

BBS 
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SHORT 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH □ 

The SHORT statement declares and reserves memory for short precision numeric variables. 



(short) - 



O 



numeric 
name 



O^ 



WX^ HsH -KiV 



Item 


Description 


Range 


numeric name 
upper bound 


name of a simple numeric variable or numeric array 
integer constant 


any valid name 
1 through 65,535 



Examples 



S H R T S h o r t V a r i a b 1 e , S h o rtflr r a m 1 < 1 8 > , S h o rtflr r a y 2 <. 5,3) 
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■■■SHORT 

Description 

All numeric variables are REAL unless declared SHORT or INTEGER. 

When the numeric variable name is used with one or two upper bound(s) enclosed in paren- 
theses, the variable is dimensioned to be a one- or two-dimensional array. The default lower 
bound of the array is 0. The OPTION BASE statement is used to set the lower bound 
equal to 1. 

When a SHORT simple variable or array element is printed to a data file, the value is stored in 
the file with REAL precision. If an entire SHORT array is printed to a data file with one 
statement (for example, P R I N T # 1 .: S h o rtflr r a y < > ), the elements are printed to the file 
with SHORT precision. 

When a REAL number is assigned to a SHORT variable, the number is rounded. Overflow 
occurs if the number is outside the range of SHORT numbers. 

When variables are passed to a subprogram by address, precision declarations accompany the 
variable into the subprogram. 

Related Keywords 

DIM, INTEGER, REAL 
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SHOW 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The SHOW statement specifies a user units scale of the plotting area such that one unit of x 
equals one unit of y (equal unit scaling). Thus, the plotting area is scaled with unit squares. 



(show) «• 



O 



O 



o 



Item 


Description 


Range 


x-min 


numeric expression 




— 


x-max 


numeric expression 




— 


y-min 


numeric expression 




— 


y-max 


numeric expresison 




_ 



Examples 

SHOW -2,2,-4,4 
SHOW fl.2*B,0,3 



Description 

SHOW scales the current plotting area, which is a function of the units mode (GU's or UU's) 
and the previously executed statements. 

■ In GU's mode, S H W scales the entire graphics area previously specified by PLOTTER I S 
or L I M I T). 

■ In UU's mode, SHOW scales the plotting area previously specified by LOCATE. If LOCATE 
has not been executed, the entire graphics area is scaled. 
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...SHOW 



The user units are established such that the specified area is as large as possible and is cen- 
tered within the plotting area. After executing SHOW, the system is set to UU's mode. 

The order of the parameters can be changed to produce reflected output (see LIMIT). 

Related Keywords 

LIMIT, LOCATE, PLOTTER IS, SCALE 
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The S I N function returns the sine of the angle argument. 



SIN 



Keyboard Executable 
Programmable 

In an IF...THEN 



("O— <(> 



numeric 
argument 



o 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 

S i n e X = S I N '■ X > 

If SIN<Theta)=l THEN DISP "Theta equals 90 degrees" 

Description 

The angle argument is interpreted according to the current trigonometric mode — RAD (radi- 
ans), DEG (degrees), or GRAD (grads). The default mode is RAD. 



Related Keywords 

fiSN, DEG, GRflD, RflD 
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s 



SINGLESTEP 



Keyboard Executable ■ 
Programmable □ 

In an IF...THEN □ 



The SINGLESTEP command executes the current program line and then halts execution. 



( SINGLESTEP ) *- 

Description 

The program must be initialized (by having previously executed IN IT or RUN). A paused, 
unaltered program need not be reinitialized. However, if a paused program is edited, it must 
be initialized before singlestepping. 

Related Keywords 

CO NT, I NIT 
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SPOLL 



Keyboard Executable I 
Programmable I 

In an IF...THEH I 

The SPOLL function returns an integer representing the status byte of the specified device. 



(S£l>— *CQ-- H sitiittr I — KT> 



Item 


Description 


Range 


device selector 


numeric expression, rounded to an integer (see glossary) 


— 



Examples 

De v i ceS t a t us = SPOLL <. ? 1 2 > 

IF SPOLL C 04X64 THEN GOSUB SOS 

Description 

The computer must be active controller in order to perform a serial poll. 

Interface-dependent actions: 

■ HP-IB: 

If the device selector is an interface select code, the interface sends Serial Poll Enable (SPE), 
sets ATN false, receives the status byte, sends Serial Poll Disable (SPD), and sends Untalk 
(UNT) 

If the device selector contains a primary address, the interface sends Unlisten (UNL), My 
Listen Address (MLA), the device Talk Address (TAD), Serial Poll Enable (SPE), and then 
sets ATN false. The interface receives the status byte and then sends Serial Poll Disable 
(SPD) and Untalk (UNT). 
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...SPOLL 



■ HP-IL: SPOLL returns the first byte received in response to a serial poll of a device. 

If the device selector is an interface select code, the interface sends Send Status (SST) and 
then waits to receive a data byte followed by End of Transmission (EOT). The interface then 
sends Untalk (UNT). 

If the device selector includes a primary address, the interface sends Unlisten (UNL), My 
Talk Address (MTA), the device talk address, and Send Status (SST). The interface then 
waits to receive the data byte followed by End of Transmission (EOT). The interface then 
sends Untalk (UNT). 

Related Keywords 

PPOLL 
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SQR 



The S Q R function returns the square root of the numeric argument, Negative arguments return 
an error. 



(j°D—<±} 



numeric 
argument 



<2> 



Item 


Description 


Range 


numeric argument 


numeric expression 


>0 



Examples 

DISP SQR<X> 

C = SQR'::fl"-2+B-'-2> 
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STATUS 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN ■ 

The STATUS statement returns the contents of one or more interface or I/O buffer status 
registers. 



( status y 



inter face 
select code 



I/O buffer 
name 



OH 



reg ister 
number 



o 



fc /Q\ f fc | numeri 
^\>J name 



Item 


Description 


Range 


interface select 
code 

I/O buffer name 

register number 

numeric name 


numeric expression, rounded to an integer 

name of a string variable declared as an I/O buffer 
numeric expression, rounded to an integer 
name of numeric variable 


3 through 10 

through 15 
any valid name 



Examples 

STATUS 7 .. .: Reg ister 

STAT U S 7 ., 3 .: R eg i s t e r 3 , Reg i s X e r 4 , Reg ister5 

Description 

The register number must be valid for the specified interface. 

When more than one numeric variable is listed, consecutive status registers are read starting at 
the specified register number. If the number of variables listed exceeds the number of existing 
registers, an error is returned; there is no wraparound to the first register. 

Related Keywords 



ASSERT, CONTROL, ENABLE IHTR, IOBUFFER 
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STOP 



See END. 
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STORE 



Keyboard Executable ■ 
Programmable D 

In an IF...THEN D 

The STORE command stores the current BASIC program or subprogram into a disc file of the 
specified name. 



(store)- 



O 



file 
name 



HP-UX 
path name 



J 



Or 



string 
expression 



Item 


Description 


Range 


file name 


literal; name of a file in the current working directory 


14 characters 
maximum; slash 
and leading colon 
not allowed 


HP-UX path name 


literal; an absolute or relative path name (see glossary) 


— 


string expression 


expression evaluating to a file name or HP-UX path name 


— 



Examples 



STORE "filename" 

STORE Vdiscl/filename" 

■• T R E " .-- Direct o r y 1 .-- Direct o r y 2 / file n a m e " 



Description 

If the file name is used alone (rather than as part of an HP-UX path name), the STORE 
operation uses the current working directory. 
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...STORE 



When S T R E is executed, the system searches the specified directory for a BASIC/PROG file 
with the indicated name. If the file is found, the current (sub)program is stored in that file, 
overwriting the previous contents. If no such file is found, the file is created in that directory. 
An error is returned if the file name already exists in the directory with another file type. 

When a new subprogram is stored, the file name must be the same as the FINDPROG name. 

Related Keywords 

LOAD, MASS STORAGE IS 



S 
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SUB 



Keyboard Executable □ 
Programmable ■ 

In an IF...THEN D 

The SUB statement is the first statement in a subprogram. It defines the beginning of the 
subprogram and lists the formal parameters passed into the subprogram. 



CiiiP)— Q- 4 ' M ZT'" h >Q 



O 



>■ ^f~P \ * ^ 1 variabl 
^>o/ \ name 



L <^r^ J 



<>y 



Item 


Description 


Range 


subprogram name 
variable name 


literal 
name of a 


numeric 


or string variable (see glossary) 


14 characters 
maximum; slash 
and leading colon 
not allowed 

any valid name 



Examples 



SUB "Count" 

SUB "SubPlot" <Xmin,Xm- 



Z v. 1 a r < , '? s ■$ ':> 



Description 

All subprograms must begin with a SUB statement. The statement cannot be part of a 
multistatement line. A subprogram can contain only one SUB statement. 
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..SUB 



The optional variable names enclosed in parentheses list the formal parameters passed from 
the calling (sub)program to the subprogram. The parameters become associated, from left to 
right, with the pass parameters listed in the CALL statement. The variable type (simple nu- 
meric, simple string, numeric array, string array) must agree with the parameters listed in the 
CALL statement. Arrays are designated by a pair of parentheses after the array name; an op- 
tional comma documents 2-dimensional arrays. Variables in the main program not explicitly 
passed to the subprogram or held in COMmon with the subprogram are unknown to the 
subprogram. 

The pass parameter list does not include precision declarations (REAL, SHORT, and INTE- 
GER), nor does it specify the dimensions of simple string variables and numeric and string 
arrays. The precision and dimensions of variables passed by address accompany them as they 
are passed. When a string expression is passed by value, the formal parameter to which it is 
passed is dimensioned to the current length of the string. 

The SUB statement can list more parameters than the calling subprogram's CALL statement. 
Extra parameters are set to and the null string. HPflR returns the number of parameters 
actually passed. 

Common variables can be passed into subprograms by including them in a COM statement. 
Unlike the parameter list of the S U B statement, the C M statement must contain both precision s 
declarations and array size declarations. 

When a subrogram is stored, it is entered into the directory as a type BASIC/SUBP file. 

Related Keywords 

CALL, FIND PROG, SCR ATCHSUB, SUB END, SUB EX IT 
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SUBEND 



Keyboard Executable D 
Programmable ■ 

In an IF. ..THEN ■ 

The SUBEND statement returns program execution to the calling program or subprogram. 



( SUBEND ) >- 

Description 

When SUBEND is executed, program execution resumes at the statement in the calling pro- 
gram that immediately follows the CALL statement. Comments following S U B E N D are part of 
the subprogram. 

SUBEND and SUB EX IT are interchangeable. 

Related Keywords 

CALL, SUB, SUBEXIT 
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SUBEXIT 



See SUBEND 



( SUBEXIT ) *- 
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SUM 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The SUN function returns the sum of all the elements in the specified array. 



(sum) — «-(?)- 



array 
name 



<>>— 



Item 


Description 


Range 


array name 


name of a one- or two-dimensional array 


any valid name 



Examples 

DISP SUM<Vectorl> 

Y=sunc:R> 



Related Keywords 



fiBSUM 
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TAB 



The TAB function is used with simple DISP and PRINT (without USING) to specify the col- 
umn in which the next output item is placed. (See DISP and PRINT). 



(«D— d> 



<D— 
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TAN 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The TAN function returns the tangent of the angle argument. 



C™0— <0— h a n P u g m u e :^ c t h -<r) 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 



T a ng e n t = T fl N < T h e t a > 

Ver t i ca 1 =Hor iion t a 1 *TflH 



Description 

The angle argument is interpreted according to the current trigonometric mode — RAD (radi- 
ans), DEG (degrees), or GRAD (grads). The default mode is RAD. 

Related Keywords 

HTM, DEG, GRflD, RHD 
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TIME 



Keyboard Executable 
Programmable 

In an IF...THEN 

The TIME function returns the current value of the system clock seconds counter. 



( time) — »- 

Description 

The seconds counter usually represents the number of seconds elapsed since midnight. The 
largest value returned is 86,399. When the counter reaches this value, it is returned to and 
the date is incremented. 

Related Keywords 

DATE, DATE*, TIME* 
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TIMES 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The TIME* function returns the system clock reading in HH:MM:SS notation. 



(time$ ) *- 

Examples 

DISP TIME* 

IF TIME*=B* THEN £00 

Description 

The string returned is in 24-hour notation in the range 00:00:00 through 23:59:59. 

Related Keywords 

DATE, DATE*, TIME 
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TRACE 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN I 

The TRACE statement traces program variable assignments and/or the order in which pro- 
gram lines are executed. 



(trace)- 



<*h> 



^-*^ var y 



o 



program 
variable 



program array 
name 



H0- 



^ 




Item 


Description 


Range 


program variable 

program array 
name 


name of a simple or array program variable 
name of a program array 


any valid name 
any valid name 



Examples 

TRACE 

TRACE ALL 

TRACE VflR Var 1 , War 2$ , flr r ay 1 ( 6 ) ., Who 1 ear ray*( ) 

Description 

Three tracing options are available: TRACE, TRACE VAR, and TRACE ALL. Tracing results 
are output to the display. 
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When tracing statements are executed within a program or subprogram, tracing is local, and 
halts when execution is transferred to another subprogram or back to the main program. 
When TRACE or TRACE ALL is executed from the keyboard, it applies to the main program 
only. When TRACE WAR is executed from the keyboard, it applies to the current program or 
subprogram. 

Tracing operations are canceled by executing NORMAL. 

TRACE. TRACE traces the order in which program lines are executed. Nothing is output 
when execution proceeds sequentially from statement to next-higher numbered statement. 
When branching occurs, TRACE outputs branching information in the form: 



(Trace line JHnumCerh ^KT^H^Sg 



TRACE VAR. TRACE UAR traces assignments to the specified program variables during pro- 
gram execution. Variables to be traced must be allocated before TRACE MAR is executed. If 
TRACE V A R is executed from the keyboard before the program is run, the program must first 
be initialized by executing IHIT. 
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...TRACE 



TRACE VflR outputs changes in variable assignments of program variables to in the form: 



C 



Trace line 



^V lin 

J numb 



numeric 
name 



string 




On 



^f ^ \ A variable I 

;r*V~/~ n value | r+" 



subscript 



<EH 



■O-n 



{T)J-J^ 



jbscript 



~& 



When a numeric variable receives a new assignment, the variable name and new value are 
output. When a string variable is assigned a new value, TRACE WAR outputs the name of the 
string variable without printing its new value. When a statement operates on an entire nu- 
meric array, the new value of the first element only is output. 

TRACE ALL. TRACE ALL traces program execution and variable assignments from line to 
line, regardless of whether or not branching occurs. Changes in the values assigned to vari- 
ables are reported in the same format as TRACE WAR output. 

Related Keywords 

NORMAL 



Keyword Dictionary 2-407 



TRANSFER (in) 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The TRANSFER (in) statement transfers bytes of data from the specified device to the specified 
I/O buffer. 



(raNJFJH) -» | se d f^° n H f^O- H I/0 n ^r 



INTR 



> 




^-»(fsh y 



rvl 



■{DELIm}— »■ byte 



_hW)-*{^1Z 



<]°L> 




<jof> 



Item 


Description 


Range 


device selector 


numeric expression, rounded to an integer (see glossary) 


— 


I/O buffer name 


name of a string variable declared as an I/O buffer 


any valid name 


byte 


numeric expression, rounded to an integer 


through 255 


number of bytes 


numeric expression, rounded to an integer 


through 65,530 
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...TRANSFER (in) 



Examples 

TRANSFER 3 TO Buffer 1* FHS 

TRANSFER fl TO Buffer 2$ INTR.: DELIM 10 COUNT 300 

Description 

Characters are placed into the buffer according to the position of the buffer fill pointer. The 
transfer terminates when the buffer is full or when any of the terminating conditions specified 
by the following keywords is met: 

■ COUNT specifies the maximum number of characters to be transferred. 

■ DELIM specifies a terminating character. The parameter following DELI M is the decimal 
value of the last character to be placed in the I/O buffer. DELI M cannot be used with F H S 
transfers. 

■ E 1 (End-or-identif y) provides for terminating the transfer when an interface-dependent 
END signal is detected. 

The interface may also have a programmable terminating condition. 

If an ON EOT branch is enabled, the branch is taken when the transfer terminates. 

Interrupt Transfer. If the INTR (interrupt) option is used, program execution continues and 
the interface is automatically enabled to interrupt the computer each time it is ready for a new 
data byte. The transfer continues to completion. If program execution stops before the transfer 
is complete, a warning is issued and the transfer continues to completion. The transfer must 
be complete before attempting to edit the program. 

Fast Handshake Transfer. If the FHS (fast handshake) option is used, the interface and 
computer are dedicated to the transfer until it is completed. No interrupts or keystrokes are 
detected until the transfer terminates. 

The procedure for clearing a system lock-up during a fast handshake transfer is machine 
dependent. 

Related Keywords 

ABORT 10, CONTROL, ENTER, HALT, IOBUFFER, ON EOT, RESET, STATUS 
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TRANSFER (out) 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The TRANSFER (out) statement transfers bytes of data from the specified I/O buffer to the 
specified device. 



(transfer)- 



1/0 buffer 
name 



<Z> 



device 
selector 



-» ( intr) 



JNmr-T 

JHS>J 



Item 


Description 


Range 


I/O buffer name 
device selector 


name of a string variable declared an I/O buffer 
numeric expression, rounded to an integer (see glossary) 


any valid name 



Examples 

TRANSFER Buffer 1$ TO 761 INTR 
T R A N S F E R M N E Y * T C h e c k i ng F H S 

Description 

Data is taken from the buffer at the position specified by the buffer empty pointer. The inter- 
face end-of-line sequence is sent following the last byte of data sent. 

The transfer halts when the buffer is empty. If an ON EOT branch is enabled, the branch is 
taken when the transfer terminates. 
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Interrupt Transfer. If the INTR (interrupt) option is used, program execution continues and 
the interface is automatically enabled to interrupt the computer each time it is ready for a new 
data byte. The transfer continues to completion. If program execution stops before the transfer 
is complete, a warning is issued and the transfer continues to completion. The transfer must 
be complete before attempting to edit the program. 

Fast Handshake Transfer. If the FHS (fast handshake) option is used, the system is dedi- 
cated to the transfer until it is completed. No interrupts or keystrokes are detected until the 
transfer terminates. 

The procedure for clearing a system lock-up during a fast handshake transfer is machine de- 
pendent. 

Related Keywords 

ABORT 10, CONTROL, HALT, I OB OFFER, OH EOT, OUTPUT, RESET, STATUS 
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TRIGGER 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The TRIGGER statement sends a Group Execute Trigger message to the specified device(s). 



(trigger y 



O 



device 
selector 



Item 


Description 


Range 


device selector 


numeric expression, rounded to an integer (see glossary) 


— 



Examples 

TRIGGER 7 
TRIGGER Dl, D2 

Description 

The computer must be active controller in order to execute TRIGGER. If more than one device 
selector is specified, the device selectors must include a primary address and the devices must 
be located at the same interface select code. 

If the device selector is an interface select code, the interface sends GET to devices addressed 
to listen. 

If the device selector(s) contain a primary address, the interface sends UNL, LAD of the speci- 
fied device(s), and GET. 

Related Keywords 

RESUME, SEND 
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TRIMS 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEH ■ 

The T R I M * function returns a string stripped of all leading and trailing spaces (ASCII decimal 
code 32). Embedded blanks are unaffected. 



(trim$) — «-(T)- 



string 
argument 



o 



Item 


Description 


Range 


string argument 


string expression 


— 



Examples 



DISP TRIM* (Title*) 

Sor t da t a* = TR I M* < Las t Name* > 
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TYP 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The TYP function returns the data type of the next item in a BASIC/DATA file. 



C^O— <Q— W^Srl — <))—>■ 



Item 


Description 


Range 


buffer number 


numeric expression, rounded to an integer 


1 through 10 



Examples 



IF TYP<3)=1 THEN READ* 
DISP TYPC Buffer ) 



i Number 



2-414 Keyword Dictionary 



...TYP 



Description 

The file must be opened. 

TYP returns an integer in the range 1 through 4, 8 through 10, according to the position of the 
file pointer and the contents of the data file. The number returned indicates the nature of the 
item following the current pointer location. 



Values Returned by TYP 


TYP Value 


Data Type 


1 


Numeric 


2 


Complete string 


3 


End-of file 


4 


End-of-record 


5 through 7 


Not used 


8 


Beginning of string; the string extends into the following record 


9 


Middle of string; the string extends into the previous and following records 


10 


End of string; the string is continued from the previous record 



Related Keywords 

REflDtt 
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UBND 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The U B H D function returns the dimension (upper bound) of the first or second subscript of the 
specified array. 



C^y- «^>- H Ta^J | HrO 4^ 



.ibscr ipt 



o-~ 



Item 


Description 


Range 


array name 
subscript 


name of a one-or two-dimensional numeric array 
numeric expression, rounded to an integer 


any valid name 
1 through 2 



Examples 



FOR 1 = 1 TO UBHD<fl,2;' 

LET Y < UBND < V , 1 > , UBND < Y , 2 > ) 

Related Keywords 

L B H D 
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u 

V 



UNCLIP 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The UN CLIP statement cancels plotting boundaries set by CLIP or LOCATE, and sets the 
plotting boundaries equal to the graphics limits. 



( UNCLIP ) — *■ 

Examples 

UNCLIP 

IF A*="Y" THEN UNCLIP 

Description 

Both SETGU and UNCLIP set the plotting boundaries equal to the graphics limits. The differ- 
ences between the two statements are: 

■ UNCLIP does not switch the current plotting units to GU's. The computer remains in the 
current units mode. 

■ UNCLIP completely cancels the CLIP or LOCATE plotting boundaries. SETGU changes the 
current plotting area but does not cancel the plotting boundaries set by CLIP or LOCATE; 
they can be restored by executing S E T U U . 

Related Keywords 

CLIP, LOCATE, SETGU, SETUU 
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UNSECURE 



Keyboard Executable ■ 
Programmable D 

In an IF. ..THEN □ 



The UNSECURE command cancels security previously specified for BASIC files. 



(unsecure)-|— -(^ 



file 
name 



tOt<XM 



HP-UX 
path name 



string 
express ion 



Item 


Description 


Range 


file name 

HP-UX path name 
string expression 
security code 

security type 


literal; name of a file in the current working directory 

literal; an absolute or relative path name (see glossary) 
expression evaluating to a file name or HP-UX path name 
string expression 

numeric expression, truncated to an integer and moduloed 4 


14 characters 
maximum; slash 
and leading colon 
not allowed 

first two charac- 
ters are used 



Examples 



UNSECURE "myf i le" , "nl" , @ 
UNSECURE "..-vol i.,-dir 1 / d i r 2 / m y t i le 



C o d e 5- 



U 
V 
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...UNSECURE 



Description 

The security type must match the security type specified for the file when it was secured. For 
types and 1 security, the first two characters of the security code must match the code that 
became associated with the file when it was secured, except that lowercase and uppercase 
letters are interchangeable. The security code is ignored for type 2 security. UNSECURE has no 
effect for security type 3. 

The following rules apply to unsecuring files: 

■ Files secured with type can be unsecured with type or 1. 

■ Files secured with type 1 can be unsecured for LIST PLIST, and editing by unsecuring for 
type 0. COPY security remains. 

■ Files secured with types and 1 can be unsecured for type 1. Type security is automati- 
cally removed. 

■ When unsecuring a file for LIST, the security must be removed before the file is loaded. 

Related Keywords 

SECURE 
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UPC$ 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The UPCf string function returns a string in which all the lowercase letters in the argument 
are converted to uppercase. 



CS*)-H<()- H a^nt I — <)) 



Item 


Description 


Range 


string argument 


string expression 


— 



Examples 



IF UPC*<String$>="YES" THEN 296 
DISP UPC*<Str ing*)&" 

Related Keywords 

LWC* 



u 

V 
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VAL 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The '...'flL function converts a string expression containing digits into a numeric value. 



C^Q— <0— H aroint \ ~+()) 



u 

V 



Item 


Description 


Range 


string argument 


string expression 


— 



Examples 

DISP URL<fl*> 

Z = ! :: l (. 1 ':.' +'...' fll_(Basel inet < X '■> > 

Description 

The string can contain leading blanks and tab characters. The mantissa begins with the first 
non-blank/tab character, which must be a plus or minus sign, decimal point, or digit. Addi- 
tional characters can be digits or a decimal point; there can be only one decimal point per 
number. 
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...VAL 



If exponential notation is used, the exponent following E or e consists of an optional sign 
folowed by two or three digits. 



VAL parameter 



© 



mantissa 



-© 







j >j 

*■ exponent ' 



The argument must contain at least one digit. Embedded blanks and non-digit characters not 
used to build an exponent terminate the number. 

Related Keywords 



u 

V 
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VAL$ 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The '...'FiL* function evaluates the numeric argument and returns the string representation of 
the argument in standard number format. 



(VAL$>— <(>-*{^ <y> 



Item 


Description 


Range 


numeric argument 


numeric expression 


— 



Examples 



C$=VflL*<D>&"00" 

P R I N T # 1 : '.,' fl L * < X c o o r d i n a t e 



Description 

The string returned has no leading or trailing blanks. Decimal numbers have a leading zero 
preceding the radix. 



Related Keywords 



'.,' H L 
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VOLUME IS 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The VOLUME... I S* statement changes the disc volume name and remounts the disc under this 
new name of the top-level directory. 



( VOLUME ) ~r-«»(^) 



c f^m — t*Ot-c 



old volume 
name 



string 
express ion 



string 
<pression 



Item 


Description 


Range 


device name" 1 " 


literal; name assigned to a mass storage unit 
ing system 


by the operat- 


— 


old volume name 


current volume name of the disc 




6 characters max- 
imum; colon, 
slash, and quota- 
tion marks not 
allowed 


new volume name 


volume name to be assigned to the disc 




6 characters max- 
imum; colon, 
slash, and quota- 
tion marks not 
allowed 



Examples 



VOLUME " :D301" IS 'V label" 
VOLUME Vtopdirl" IS "topdirS" 

* Implemented only for single-user systems with removable file systems. 
t Machine-dependent parameter. 



u 

V 
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...VOLUME...IS 



Description 

A volume name is created on the disc when the disc is formatted. When the disc is mounted, 
the volume name becomes the name of the top-level directory. UOLUME...IS can change 
names of top-level directories only. 

Related Keywords 

MASS STORAGE IS 



U 
V 
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WAIT 



Keyboard Executable ■ 
Programmable ■ 

In an IF... THEN I 

The WAIT statement causes a delay in program execution until the specified number of milli- 
seconds has elapsed. 



( WAIT J — ^ milliseconds 



Item 


Description 


Range 


milliseconds 


numeric expression 


>1 



Examples 

WHIT N*250 

IF X=7 THEN WAIT 5980 

Description 

The WAIT statement can be interrupted by pausing the program. When the program is contin- 
ued, execution continues at the next statement. 

Related Keywords 

PAUSE 



W 
X 
Y 
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WHERE 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The WHERE statement assigns the last known location and status of the plotting device's logi- 
cal pen to the specified numeric variables. 



AlHFnF^ J x-coordinate I ^f~~\ fc 
yinCHly ; H variable | H^^ ^ 



y-coordinate 
variable 



y, fc /*"*^ ^ pen status ) 

^"\^1/ i variable | 



w 

X 
Y 



Item 


Description 


Range 


x-coordinate 
variable 

y-coordinate 
variable 

pen status 
variable 


name of a numeric variable 
name of a numeric variable 
name of a numeric variable 


any valid name 
any valid name 
any valid name 



Examples 



W HERE X p o s i t i o n , Y P o s i t i o n , P e n stat u : 
WHERE x ■:: I > , y< I > 
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Description 

The pen x- and y- coordinates are interpreted according to the current units. The pen status 
variable is assigned the value if the pen is up, 1 if the pen is down. 

The location and status of the logical pen is determined by the most recently executed state- 
ment affecting the pen. This includes all plotting statements and all statements and conditions 
which activate the graphics default conditions (see glossary). When the graphics default con- 
ditions are activated, the logical pen is lifted and moved to the origin (0,0). 

Related Keywords 

CURSOR, DIGITIZE 



W 
X 
Y 
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XAXIS 



Keyboard Executable ■ 
Programmable ■ 

In an IF...THEN ■ 

The "X fl X I S statement draws a horizontal axis, with optional tick marks, at the specified y- 
intercept. 



y-intercept 



{ 0-£ 



Lck-spac inc 



^-*\'J — »> x-min — ^V*J — ** 



Item 


Description 


Range 


y-intercept 


numeric expression, interpreted according to the current 
units (default = 0) 


— 


tick-spacing 


numeric expression, interpreted according to the current 
units (default =0; no ticks) 


— 


x-min 


numeric expression, interpreted according to the current 
units (default = the entire plotting area) 


— 


x-max 


numeric expression, interpreted according to the current 
units (default =the entire plotting area) 


— 



Examples 



:axi 

IRXI 
I FIX I 



(. Y rii a x - Y m i n ':> .-■■ 2 ., 1 
Y (. 1 > , 2 , - 1 2 , 1 2 



W 
X 
Y 
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Description 

The axis and optional tick marks are drawn using the current line type, and are clipped at the 
plotting boundaries. The y-intercept may lie outside the plotting area; only the portion of the 
axis within the plotting area is shown. The x-min and x-max parameters provide for drawing 
an axis across a portion of the plotting area. Parameters outside the plotting area are ignored. 
The default axis length is the entire plotting area. 

Tick marks are 2 GU's long. The sign of the tick spacing parameter determines where ticks are 
placed. If the tick-spacing parameter is positive, ticks are left-justified on the x-axis. If the tick 
spacing parameter is negative, ticks are right-justified. 

Related Keywords 

AXES, LAKES, VAX IS 



W 
X 
Y 
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XREF L 



Keyboard Executable 
Programmable 

In an IF...THEN 



The XREF L statement displays a line cross-reference table of program line numbers, line 
labels, and user-defined functions in the current (sub)program. 



C 



XREF L 



Description 

XREF L generates an entry in the line cross-reference table whenever a line number or line 
label is referenced. Table entries are in the form: 

referenced line number [line label] o c c u r s o n referencing line(s) 

For example, the program lines: 

30 IF X#5 THEN loop 

5 1 o o p : FOR 1 = 1 t o 5 

generate the entry: 

5 loop; o c c u r s o n 3 

The system displays , , .end o f x ret 1 when the entire table has been displayed. 

Related Keywords 

LIST, SCAN, XREF'., 1 
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XREF V 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The XREF V statement displays a cross-reference table of all the variables and user-defined 
functions in the current sub(program). 



( XREF v ) — »- 

Description 

The XREF V table contains the following information about each program variable: 

l Jar iable — the name of the variable or user-defined function. 

Dirnl — the upper bound of the first subscript in an array variable. 

Dim 2 — the upper bound of the second subscript in an array variable. 

Maxl — the maximum length of a string variable. 

Type— REAL, SHORT, INTEGER, or string. 

References — lines referencing the variable or user-defined function, including func- 
tion definitions (DEF FN statements), function value assignments (FH...=), and function 
calls (FN). 

The system displays , , , end o t x r e f v when the entire table has been generated. 

Related Keywords 

LIST, SCAN, XREFL 



W 
X 
Y 
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YAXIS 



Keyboard Executable ■ 
Programmable ■ 

In an IF. ..THEN ■ 

The V fl 'A I S statement draws a horizontal axis, with optional tick marks, at the specified x- 
intercept. 



(YAXIS) — »■ x-in 



itercept 



^ — *4 i j » ■ t ick-spac inc 



^-*\ ' ) — > y-min — *\ 'J — ^ 



Item 


Description 


Range 


x-intercept 


numeric expression, interpreted according to the current 
units (default = 0) 


— 


tick-spacing 


numeric expression, interpreted according to the current 
units (default =0; no ticks) 


— 


y-min 


numeric expression, interpreted according to the current 
units (default = the entire plotting area) 


— 


y-max 


numeric expression, interpreted according to the current 
units (default = the entire plotting area) 


— 



Examples 





YflXIS 3 




VAX IS K(I 




YfltfIS 3, 1 


w 




X 




Y 
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Description 

The axis and optional tick marks are drawn using the current line type, and are clipped at the 
plotting boundaries. The x-intercept can lie outside the plotting area; only the portion of the 
axis within the plotting area is shown. The y-min and y-max parameters provide for drawing 
an axis across a portion of the plotting area. Parameters outside the plotting boundaries are 
ignored. The default axis length is the entire plotting area. 

Tick marks are 2 GU's long. The sign of the tick spacing parameter determines where ticks are 
placed. If the tick spacing parameter is positive, ticks are bottom-justified on the y-axis. If the 
tick spacing parameter is negative, ticks are top-justified. 

Related Keywords 

AXES, LfiXES, XfiXIS 
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82860-90002 
Printed in U.S.A. 



Reader Comment Card 



We welcome your evaluation of this manual. Your comments and suggestions help us improve 
our publications. 



Manual Title and/or Part number. 



Please circle one number for each of the statements below. 



The manual is well organized. 

I can find the information I want. 

The information in the manual is accurate. 

I can easily understand the instructions 

and procedures. 

The manual is clearly written. 

The manual contains enough examples. 

The examples are appropriate and helpful. 

The layout and format are attractive and useful. 

The illustrations are clear and helpful. 

I like the use of color in the manual. 



Strongly 
Agree 


Agree 


Neutral 


Disagree 


Strongly 
Disagree 
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Please feel free to write additional comments, particularly if you disagree with a statement 
above. Use additional pages if you wish — the more detailed your comments, the more useful 
they are to us. 



Comments: 



Name: 
Title: 



Company:. 
Address: 



City/State/Zip:_ 
Phone : 
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Reader Comment Card 



We welcome your evaluation of this manual. Your comments and suggestions help us improve 
our publications. 

Manual Title and/or Part number 



Please circle one number for each of the statements below. 

Strongly 



The manual is well organized. 

I can find the information I want. 

The information in the manual is accurate. 

I can easily understand the instructions 

and procedures. 

The manual is clearly written. 

The manual contains enough examples. 

The examples are appropriate and helpful. 

The layout and format are attractive and useful. 

The illustrations are clear and helpful. 

I like the use of color in the manual. 



Agree 



Agree Neutral Disagree 



Strongly 
Disagree 
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Software 
Customer Support 



Much of the information in this booklet is taken from the 
Support Guide that came with your HP computer. Refer to that 
booklet for more information on customer support. 



License 

Agreement and 
Warranty 



Before opening the package containing the disc(s) or software 
module(s), be sure to read the software's licensing agreement 
in the booklet marked License Agreement and Limited Warranty. 
That booklet also contains the warranty information for this 
software product. 



Customer 
Assistance — 
Getting Help 



To locate a local dealer or HP Sales and Service Office, refer 
to the "Directory" printed in the back of the Support Guide 
that came with your compter. If you don't have the Support 
Guide, you can call one of the following numbers for this in- 
formation: In the U.S., call 800/FOR-HPPC. In Europe or the 
U.K., contact Hewlett-Packard, S.A. in Geneva (022/83 81 
11). If you are outside the U.S. and Europe, contact Hewlett- 
Packard Intercontinental in California (415/857-1501). 



For telephone assistance in operating your computer, call one of 
the following numbers. 

■ In the U.S. call the North American Response Center — 
1-800/858-8867. 

■ In Canada call 1-800/267-6115. 

■ In other countries call your HP Sales and Service Office. 



Software 
Updates and 
Replacements 



Updated and upgraded software and manuals are available to 
current owners as improvements and corrections occur. Con- 
tact your dealer or an HP Sales and Service Office for this 
service. 

For disc-based software a new disc is provided at a nominal 
charge in exchange for your original master disc. For ROM- 
based software a new ROM cartridge is provided. 

Creating copies of your master discs and your work discs 
minimizes the risk of damage to your original (master) soft- 
ware discs. Should a master software disc be destroyed, 
however, replacement discs are available for software distrib- 
uted by Hewlett-Packard. 
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